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IMPORTANT NOTICE 


° If you are using Simul-Task (MS-DOS* running under 
UNIX**) on the AT&T PC 6300 PLUS, and your "Simul-Task 
OS Merge" diskette is labeled "Ver 2.1" while your "UNIX 
Foundation Set" diskettes are labeled "Ver 2.0," then you 
cannot use MS-DOS Version 3.2 with Simul-Task. MS-DOS 
Version 3.2 will, however, work on the PC 6300 or PC 6300 
PLUS without Simul-Task. For more information on a 
pending upgrade to Simul-Task to support MS-DOS Version 3.2, 
call the AT&T Customer Information Center at 1-800-432-6600. 
In the meantime, use MS-DOS 3.1 with Simul-Task. 


If you have installed the AT&T Mouse and your computer's 
ROM BIOS chip is Version 1.21 or earlier, you cannot use MS- 
DOS Version 3.2 with the AT&T Mouse. (When you start your 
computer, the ROM BIOS version number appears at the top 
of the display screen, under the words "Resident Diagnostics.") 
To order a new Version 1.43 ROM BIOS chip, call the AT&T 
National Parts Sales Center at 1-800-222-PART. 


Your MS-DOS Supplemental Programs Diskette has a file 
named READ.ME that contains changes and additions to the 
MS-DOS User's Guide Version 3.2. 


To see the contents of the file, first start MS-DOS. Then use 


the TYPE command, described on page 4-35, to display 
READ.ME on the display screen. 


Registered trademark of Microsoft. 


** Registered trademark of AT&T. 
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Dear Customer, 


Attached are replacement pages for the Getting Started With Your 
AT&T Personal Computer 6300 PLUS Guide. These replacement pages 
reflect the latest release of the AT&T MS-DOS Operating System, 
Release 3.2. 


You should remove the pages currently in Chapter 4, “Getting Started 
With MS-DOS—Hard Disk Drive,’ under the section ‘Preparing, 
Your Hard Disk for Use’ and replace them with the attached pages. 
This section of the getting started guide discusses how you partition 
and format your hard disk drive. 


Note: MS-DOS 3.2 cannot be used with the 2.0 release of 
Simul-Task. If your seven UNIX system “Foundation Set” 
floppy diskettes have ‘Version 2.0” written on them and 

your ‘‘Simul-Task OS Merge Disk” has “Version 2.1,” you 
should continue using MS-DOS Version 3.1 at this time. For 
information on the latest version of Simul-Task, call the 

AT&T Information Systems Software Hotline at 1-800-922-0354. 
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Introduction 


Introduction 


This guide gives you the concepts and rationale behind the 
MS-DOS procedures. It presents the material in the natural 
sequence you follow when using MS-DOS. 


What’s New 
AT&T has added many important new features to MS-DOS. You 
can now use MS-DOS with the following devices: 
e Large fixed disks, from 32 megabytes (Mb) all the way to 
128 Mb 
e 3%-inch, 720-kilobyte (Kb) and 1.44 Mb diskettes 
e The AT&T 477 Graphics Color Printer. 


Other features make MS-DOS easier and more powerful to use: 


e A customizable HELP command with information on 
approximately 100 topics related to MS-DOS. 


e An automatic INSTLDOS procedure to set up a new fixed 
disk or upgrade older versions of MS-DOS on your present 
fixed disk. 

e A RAMDRIVE that turns part of your computer’s memory 
into a fast, temporary random-access memory (RAM) disk. 


e TAG, EXEC, and UNTAG commands that let you specify 
any group of files you wish and perform MS-DOS 
commands on all of them at once. 


More than a dozen other new and enhanced commands, 
such as AC.SYS, ATTRIB, and VDISK.SYS. 
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What Is MS-DOS? 


ey 


MS-DOS stands for Microsoft-Disk Operating System. An 
operating system is the traffic director of your computer. Like 
the signals at a busy intersection directing cars, the computer's 
operating system is at the center of activity directing data. 
MS-DOS is an operating system designed to run your AT&T 
computer. It coordinates the flow of information between the 
screen, keyboard, memory, and storage disks. It also directs other 
devices attached to your computer, such as a printer or modem. 
MS-DOS is necessary to run applications programs that let you 
create and manage files on your AT&T computer. 


You can make your computer perform certain tasks with a set of 
MS-DOS commands. This guide teaches both the fundamental 
MS-DOS commands and the more advanced commands that will 
extend your computing power. 


Introduction 


What Is Covered in This Guide? 


The information in this guide is organized as follows: 


* Chapter 1, Introduction, explains how to follow the 
examples in this guide. It also contains a checklist of the 
diskettes containing MS-DOS. 


Chapters 2 and 3, Before You Start MS-DOS and Starting 
MS-DOS, introduce you to the basic concepts of MS-DOS 
and some of the important practices you should follow 
when working with a computer. You will also learn about 
diskettes and files, how to identify what type of system 
you have, how to use your computer’s keyboard with 
MS-DOS, and how to set up MS-DOS Version 3.2 on your 
system, with or without a fixed disk. 


Chapter 4, Using MS-DOS Commands, explains the 
concepts you've learned and puts them into practice. 
Contained here is a step-by-step introduction to the most 
commonly used MS-DOS commands, some information 
about displaying help information, configuring your 
computer system, automatic processing, and a recap of 
some useful practices. 


Chapters 5 and 6, MS-DOS Commands and Batch 
Processing Commands, are reference chapters. They 
contain alphabetic listings of each of the MS-DOS 
commands, purpose, correct syntax, rules of usage, and 
examples that illustrate how each command is used. 


Chapter 7, Getting Help, explains how to install and use 
the AT&T Help facility for MS-DOS. In addition, it 
contains instructions on how to customize the standard 
help files, create other help files, and maintain all help file 
information. 
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At the end of this guide are appendices: 


© Appendix A, Messages, contains an alphabetical listing of 
the error messages that MS-DOS displays when it cannot 
do a requested task. 


e Appendix B, EDLIN—The Line Editor, describes the 
functions and commands of the EDLIN line editor program 
supplied on your MS-DOS System Diskette. EDLIN lets 
you create, change, and display files that contain source 
programs or text. 


e Appendix C, LINK Program, explains the LINK program, 
supplied on your MS-DOS Supplemental Programs 
Diskette, that combines object modules output from the 
MASM assembler or other compatible compilers and 
assemblers. 


e Appendix D, DEBUG Program, describes DEBUG, a 
program supplied on your MS-DOS Supplemental 
Programs Diskette that allows you to examine a program 
instruction by instruction, change register and file contents 
for testing during a DEBUG session, make permanent 
changes to disk files, and unassemble machine code 
instructions into assembly language equivalents. 


Appendix E, CONFIG.SYS, explains the commands used 
in the CONFIG.SYS ("configure system") file, a special file 
MS-DOS uses to set or change system parameters or 
augment the operating environment by executing the 
commands in this file when you start your computer. 


e Appendix F, EXE2BIN, describes the EXE2BIN command 
that converts executable files into binary files. 
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¢ Appendix G, ANSI.SYS, explains how to install and use 
the ANSI.SYS device driver program, a program that 
allows you to use escape sequences to affect cursor 
movement, change graphics functions such as screen color 
and resolution, and reassign functions to keyboard keys. 


e Appendix H, DRIVER.SYS, describes the DRIVER.SYS 
device driver program, a program that allows you to add 
more than four diskette drives or two fixed disk drives to 
your computer. 


e Appendix I, RAMDRIVE.SYS, describes the 
RAMDRIVE.SYS device driver program, a program that 
allows you to use memory as if it were a physical disk to 
increase the speed at which the computer accesses data 
stored there. 


e Appendix J, ASCII Character Values, contains a table of all 
the characters your computer can display and their decimal 
ASCII values. 


e Appendix K, AC.SYS, describes the AC.SYS device driver 
program, a program that allows you to use a portion of the 
machine’s random access memory as a disk cache for the 
hard disk. 


e Appendix L, VDISK.SYS, describes the VDISK.SYS device 
driver program, a program that allows you use memory as 
if it were a physical disk to increase the speed at which the 
computer accesses data stored there. 
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How To Enter Keystrokes 
SE 


Later in this guide you will be provided with step-by-step 
procedures to follow. You are instructed to type certain words 
and characters and to press specific keys. It is important to type 
exactly what is shown in the indented example (only the boldface 
part): 


A> type this 


The specific keys or sequence of keys that you should press 
appear in boldface capital letters like this: 


RETURN 
or 


CTRL-NUM LOCK 


In a sequence of two or more keys (such as CTRL and NUM 
LOCK), press and hold down the first key(s) while you press the 
last key in the list and then release them. 


All other punctuation—commas, colons, slash marks, equal signs, 
spaces—must be entered exactly as shown. 
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What Is Included With This Guide? 


This MS-DOS User’s Guide Version 3.2 comes with the following 


5%-inch diskettes: 


e MS-DOS System Diskette 
This diskette contains MS-DOS and its related programs. 

e MS-DOS Supplemental Programs Diskette 
This diskette contains the BASIC, BASICA, DEBUG, 
EXE2BIN, GWBASIC, BACKUP, RESTORE, LINK, and 
other programs. 

e MS-DOS/AT&T Help Diskette 
This diskette contains the HELP command and files of help 
information on MS-DOS-related topics. 


3%-inch diskettes: 


e MS-DOS System Diskette 
This diskette contains MS-DOS and its related programs. 


e MS-DOS/AT&T Help Diskette 
This diskette contains the HELP command and files of help 
information on MS-DOS-related topics. 


All diskettes are in the plastic pocket at the back of this guide. 
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This chapter introduces you to some of the important concepts 
and practices you must know before you start using MS-DOS. If 
you are unfamiliar with using a computer and diskettes, read the 
About Diskettes section of this chapter carefully. If you have 
experience with computers, the practices in this section are 
second nature to you. New and experienced users alike should 
read the Files section, as the information there describes the file- 
naming rules used by MS-DOS. 
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The following sections cover the basic information you need to 
know about diskettes. If you are new to using computers, you 
should read these sections carefully. 


Caring for Diskettes 


Your diskettes are valuable. They contain information 
representing hundreds of hours of work. You must handle them 
carefully and follow prudent back-up and archival practices. 


The illustrations and hints on the following pages apply to three 
types of 54-inch diskettes: 

° Single-sided (180-Kb) diskettes 

© Double-sided (360-Kb) diskettes 

© High-capacity (1.2-Mb) diskettes. 
(The abbreviations Kb and Mb refer to disk capacity. They are 


explained in the Tracks, Sectors, and Compatibility section of 
this chapter.) 
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Here are some rules and helpful hints to follow: 
* Always keep a diskette in its envelope when it’s not in 


use. The envelopes are specially treated to resist static 
electricity and dust accumulation. 


| ee 


© Never touch the magnetic surface of a diskette exposed in 
the oval window. Handle the diskette by its protective 
cover, as shown. 


oc 
© 
0 
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° Never bend or fold a diskette. 


* Store and use diskettes in a safe environment. Don’t let 
them get too cold or too hot. Keep them out of the sun or 
the trunks of automobiles. 


O 


L 


bsstyas 
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* Keep diskettes away from magnets or strong electrical 
fields. Keep diskettes away from your telephone. The 
information stored on a diskette can be damaged or erased. 


Always be very careful when inserting a diskette into a 
drive: 


— Remove the diskette from its paper envelope. 
— Open the drive door. 


— Hold the diskette with its label side up and toward 
you. 


— Gently push the diskette into the drive (don’t force it). 


— Close the drive door. 
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* Don’t write on a diskette with a ball-point pen or a pencil. 
Use only a soft felt-tip marker. Better yet, prepare the 
diskette’s label first, then apply it to the diskette. 


oO | MS DOS 
@) O 
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Write-Enable Notch 


Notice the small notch on a diskette below the label on the right. 


4) one 
U 


This is called the write-enable notch. If you cover the write-enable 
notch, the computer can only read information from the diskette; 
it cannot write information to the diskette. This means that data 
existing on the diskette cannot be accidentally erased or written 
over by the computer. 


You can cover the notch with a write-protect tab supplied with the 
diskette or with a piece of opaque tape. You can remove the tab 
when you want to add or erase information. 


It’s a good idea to protect your important diskettes this way. 
Many of the program diskettes you may buy have no notch. Such 


notchless diskettes are already "write protected." The computer 
cannot write any information onto a write-protected diskette. 
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About 3*2-Inch Diskettes 


MS-DOS Version 3.2 allows you to use disk drives for 3¥2-inch, 
720-Kb or 1.44 Mb diskettes. These diskettes are smaller and 
sturdier than the diskettes described on the preceding pages. 


These diskettes have an inflexible plastic cover and a metal shutter 
that slides open to expose the diskette’s magnetic surface when 
the diskette is inserted in a 3%-inch diskette drive. 


Some of the rules for diskette care are different for 3%-inch 
diskettes: 

e A paper envelope is not required. 

© It is difficult to bend or fold these diskettes. 


e You can write on the labels with ball-point pens (but felt- 
tip markers are still preferred). 


e You write-protect a 3¥2-inch diskette by sliding the plastic 
tab toward the corner and exposing a hole in the cover. 
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Other diskette-care rules still apply: 


e Never touch the magnetic surface of the diskette. 
e Avoid extreme temperatures. 
e Avoid magnets and strong electrical fields. 


e When inserting diskettes into drives, keep the label side up 
and don’t force it into place. 


A Few Words About Fixed Disks 


Like a diskette, a fixed disk is a disk with a magnetic surface. The 
disk itself is permanently mounted inside its drive. When it 
operates, the disk spins at thousands of revolutions per minute, 
less than a thousandth of an inch from the heads that read and 
write data on its surface. It’s more susceptible to smoke, 
vibration, and sudden temperature changes than diskettes are. 
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less than a thousandth of an inch from the heads that read and 
write data on its surface. It’s more susceptible to smoke, vibration, 
and sudden temperature changes than diskettes are. 


A fixed disk can hold much more information than a diskette. Its 
total capacity can be from 10 Mb to 128 Mb. You can read from or 
write to a fixed disk much more quickly than reading from or 
writing to diskettes. 


However, a carelessly entered command could affect, or even 
destroy, a lot of data on your fixed disk. MS-DOS can protect you 
from some, but not all, of these mistakes. This guide provides 
other tips for keeping your data safe. Try to follow them. 


You'll find more information about setting up and organizing 
fixed disks in Chapter 3, Starting MS-DOS. 


Why Copy Your MS-DOS Diskettes? 


Your MS-DOS System Diskette, MS-DOS Supplemental Programs 
Diskette, and MS-DOS/AT&T Help Diskette hold all of the 
programs you need to make your computer operate. Disks can be 
lost, physically damaged, and, on occasion, accidentally erased by 
sudden electrical surges in your computer or power systems. To 
protect the diskettes, make a working copy of each diskette and 
save the original, or master diskette, in a safe place. The 
DISKCOPY command, described in Chapter 4, creates working 
copies of diskettes. 


You should use a master diskette only to make additional 
working copies. If you have a fixed disk, you can copy the 
programs directly to the fixed disk, which becomes their working 
disk. 
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It’s also important to make copies of the work you do on your 
computer. Losing the only copy of your work can be as 
catastrophic as losing the only copy of a needed program. This is 
especially true when you use a fixed disk. The BACKUP and 
RESTORE commands, described in Chapter 5, back up (copy) 
information from the fixed disk to special back-up diskettes and 
restore information from back-up diskettes to the fixed disk, 
respectively. It is a good idea to save your data on back-up 
diskettes often. 


When copying diskettes, be sure to: 


© Use a felt-tip marker to label and date each working copy 
diskette. 


© Store the original or master diskettes in their paper 
envelopes in a safe place. 


° Use the working copy diskettes in your daily work. 


Diskettes Need To Be Formatted 


Before you can use a brand new or blank diskette with MS-DOS, 
you must format the diskette. You need only do this once—before 
you use a diskette for the first time. 


Formatting a diskette prepares it to receive and store data. Think 
of it this way: Formatting is like putting lines on a newly paved 
parking lot so that cars can be parked in an orderly and efficient 
way. Formatting doesn’t physically write lines, but it marks tracks 
and sectors (described in the following section) on a new diskette. 
Data, then, is placed on the diskette in an orderly way and can be 
easily found and read. 
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If you have a fixed disk, the INSTLDOS command, described in 
the Automatically Setting Up a Fixed Disk section of Chapter 3, 
automatically partitions (divides) and formats the fixed disk. A 
fixed disk must be partitioned so that MS-DOS considers it to be 
one or more drives, and then each of its partitions must be 
formatted before you can use it. See Chapter 3, Starting 
MS-DOS, for more information on partitioning and setting up a 
fixed disk. 


Warning: If a fixed disk or diskette has been formatted and 
contains data, formatting the disk again will irreversibly 
destroy any data on the disk. 


Tracks, Sectors, and Compatibility 


When a disk is formatted, its tracks and sectors are marked. 


Tracks are concentric circles as shown on the diskette pictured 
below. As a disk spins, one of the drive heads that read and write 
data on a diskette can access an entire track without having to 
move. 
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Sectors are sections of tracks. A sector is the smallest unit of data 
that MS-DOS can read from or write to a disk at one time. The 
number of tracks and sectors varies with the type of disk. 


A byte is the amount of information needed to identify one 
character. Other units of data measurement are multiples of the 
byte: the kilobyte (Kb) equals 1,024 bytes, and the megabyte (Mb) 
equals 1,024 Kb, or 1,048,576 bytes. A sector of a diskette 
contains 512 bytes, exactly half of a kilobyte. 


Your AT&T personal computer can be equipped with one or more 
of three different types of diskette drives: 360-Kb, double-sided, 
5%-inch; 1.44-Mb, double-sided, 3¥2-inch; and 1.2-Mb, double- 
sided, high-capacity, 5%-inch. Each drive puts tracks and sectors 
on diskettes in a different pattern. 


A 360-Kb diskette drive can format diskettes and read and write 
data on them in four different ways: 


e One side, 40 tracks, eight sectors, 160-Kb capacity 

e One side, 40 tracks, nine sectors, 180-Kb capacity 

e Two sides, 40 tracks per side, eight sectors, 320-Kb 

capacity 

e Two sides, 40 tracks per side, nine sectors, 360-kb capacity. 
A 1.2-Mb diskette drive can format, read, and write any diskette 
listed above that a 360-Kb diskette drive can use. However, if you 
format or write data on one of the diskettes listed above using a 


1.2-Mb diskette drive, you may not be able to read the diskette 
later with a 360-Kb diskette drive. 


2-14 


Before You Start MS-DOS 


ET 


A 1.2-Mb diskette drive can also format, read, and write 1.2-Mb 
diskettes, which have two sides, 80 tracks per side, and 15 
sectors. 


A 1.44-Mb, 31%,-inch diskette drive can format, read, or write 720- 
Kb or 1.44-Mb, 34-inch diskettes. These diskettes have two sides, 
80 tracks per side, and 15 sectors. 


Most MS-DOS commands that transfer data from disk to disk 
automatically compensate for these differences. However, the 
FORMAT, DISKCOMP, and DISKCOPY commands (discussed in 
Chapter 5) do not, since they read disks track by track and sector 
by sector. DISKCOMP and DISKCOPY will display error 
messages if you try to compare or copy two different diskette 


types. 
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What Kind of System Do You Have? 


Your computer system unit operates with either: 


e A single diskette drive 
¢ Two diskette drives 
A fixed (nonremovable) disk and a diskette drive. 


In this chapter, you learn how to use MS-DOS with these 
configurations. 


In our examples, we use the following conventions to distinguish 
between the drives in a two-drive system. These are common 
synonyms, used by the computer industry and by users alike. 


Drive A Drive B 

(or diskette A) (or diskette B) 

is also called: is also called: 
Source Target or Destination 
Original Back-up 

Master New or Blank 

First Second 
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If You Have a Single-Diskette-Drive System 


If you have a single-diskette-drive system, MS-DOS identifies the 
drive as both drive A and drive B. 


If you have already inserted a diskette into drive A and MS-DOS 
tells you to insert a diskette into drive B, take out the first 
diskette and put the second diskette into the drive. 
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If You Have a Two-Diskette-Drive System 


If you have a two-diskette-drive system, MS-DOS identifies the 
bottom drive as drive A and the top drive as drive B. 


If MS-DOS tells you to insert a diskette into drive A and, later, a 
diskette into drive B, you can insert diskettes into the respective 
drives. 
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If You Have a Fixed Disk Drive and a Diskette Drive 
System 


A fixed disk is treated just like a diskette for most of the MS-DOS 
commands. 


Some MS-DOS commands are used only with a fixed disk drive. 
Some are used only with diskettes. 


MS-DOS identifies the diskette drive as drive A and the fixed disk 
as drive C. If you create multiple partitions on the fixed disk, 
MS-DOS treats each partition as a separate drive and assigns them 
the letters D, E, and F, as needed. See Chapter 3, Starting 
MS-DOS, for more information about partitions and fixed disks. 


Fixed Disk 
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Information is stored in files on your diskettes or fixed disk. A 
diskette or disk directory is like a drawer in a conventional filing 
cabinet, and a computer file is like a file folder in the drawer. It 
contains related data on a specific subject. 


AMELIA.LTR: 
CHARLES.LTR 
EOLIN.COM 


Files on your diskettes can contain many different types of 
information. There are text and data files—files that contain 
information that you create with a word processing or 
spreadsheet program. Other kinds of files are program files. 
These files contain the instructions used by your computer to 
perform a task or complex operation. Program files are created 
using a programming language such as BASIC or Pascal—or other 
specialized languages—and are meant to be used by a computer, 


rather than by a person. 
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Files on a disk may be grouped into collections called directories. 
Usually, a diskette contains a single directory and a fixed disk 
drive contains multiple directories. Since a fixed disk has enough 
toom for hundreds of files, organizing these files into directories 
makes it easier to find and work with the files you need. The 
Organizing Your Fixed Disk section of Chapter 3 contains more 
information on directories. 


Naming Files 


Each file on a diskette or in a disk directory must have its own 
unique filename. This way your computer can find the file you 
want. You can use the same filename on two different diskettes 
or in two different directories, but this may lead to problems later 
when you are copying a file from one disk or directory to 
another. 


A filename is composed of: 


° A name of 1 to 8 characters 


* A period, required as separator if an extension (an optional 
identifier) is used 


° An extension of 1 to 3 characters. 
Acceptable characters in a filename are: 


° Letters of the alphabet 
° Numbers 0 through 9 


* These special characters: 
HS&E@!%()-[ 77 }_ 
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All filenames appear in this format: 
name.extension 


Note: Spaces between characters are not allowed. 


Examples of acceptable filenames are: 


DEBUG.COM START.BAS 
PHDTHSIS.78 MOM&SIS.LTR 
TAXES$.85 CH3PART1 
HHA 


Although the last filename on this list is legitimate, it doesn’t 
give you much information about the contents of the file. A good 
filename reminds you of the information contained in the file. A 
good extension tells you the kind of information, such as text, 
data, or a program. 


Reserved Filenames and Extensions 


Some filenames have a special meaning in MS-DOS. Some 
filenames identify the hardware parts of your computer or its 
accessories. Some extensions identify types of files handled in a 
special way by your computer. 
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Do not use the reserved filenames listed in the table below when 
naming your own files. 


Filename | Meaning 

AUX Refers to auxiliary device connected to the 
serial port—a printer or a modem 

COM1 See AUX 

COM2 A second serial device 

CON Refers to input from the keyboard or 
output to the display 

NUL Used when an input or output device 
name is needed, but no communication is 
desired 

PRN Refers to the printer connected to the 
parallel port 

LPT1 See PRN 

LPT2 A second parallel printer 

LPT3 A third parallel printer 
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Extensions 


The table below shows some of the special extensions that you 
may use from time to time to identify program or data files that 
are used by a computer to perform some operation. For example, 
if you write a batch processing program that performs a series of 
MS-DOS commands (see Chapter 6), you use the extension BAT 
to tell MS-DOS how to handle the file whenever you want to run 
that program. 


Extension | Meaning 

-BAS | A BASIC program 
.BAT A batch program 
-COM An executable program 
-DAT A data file 

-EXE An executable program 
.PLH A help file 

SYS A device driver 


Note: There are other standard extensions used by 
programming languages and application programs. You can 
also add extensions of your own to the list. 
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Wild-Card Characters 


When you are using MS-DOS file commands, the wild-card 
characters * and ? let you type a single command that works 
with multiple files. These characters provide flexibility in making 
choices about filenames. 


The ? character indicates that any valid character may occupy that 
position in a filename or extension. For example: 


dir inv???.85 


lists all directory entries that begin with INV, have up to three 
following characters, and end with the extension 85. For 
example, these files might be found: 


INV.85 
INV003.85, 
INVOIC.85 


Similarly, the command: 
dir memo .?qr 
might list the following directory entries: 


MEMO.1QR MEMO.3QR 
MEMO.2QR MEMO.4QR 
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The * character in a filename indicates that any valid character 
can be in that position, all remaining positions, or in the 
extension. For example: 


dir *.dat 


lists all directory entries with the extension .DAT. These files 
might be found: 


85.DAT PAUL.DAT 
INVENTRY.DAT Q185.DAT 


Similarly, the command: 
dir memo.* 
might list these directory entries: 


MEMO.JAN 
MEMO.1QR 
MEMO.86 


The wild-card characters * and ? can be used together. They are 
powerful tools and should be used very carefully, particularly 
when using the DELete command (described in Chapter 5). 
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Specifying Drives 


When you want to refer to a file, you must tell MS-DOS where to 
search for it—that is, you must specify which drive and which 
directory contains the disk with that file. MS-DOS identifies disks 
with a single letter from A to Z. A colon (:) is used to separate 
the drive identifier from the pathname, which identifies the 
directory that contains the file, and the filename. For example: 


B:\MYPATH\MYFILE.LTR 


identifies the file MYFILE.LTR in the directory MYPATH on 
drive B. 


To MS-DOS, a drive can be: 


e A diskette drive 
e A fixed disk partition 
e A virtual disk created with RAMDRIVE or VDISK. 


Note: Use VDISK only on machines that have the 
80386 processor. 


e A network drive located on another computer 


e A drive alias (for a pathname) created with the SUBSTitute 
command (described in Chapter 5). 


One of these drives is always the current, or default, drive. It’s 
the one identified in the standard MS-DOS prompt. (For more 
information, see the When MS-DOS Is Ready: The Prompt 

section in Chapter 3.) MS-DOS always looks for your specified 
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file on the current directory in the default drive, unless you 
specify a different drive or directory. For instance, if you type: 


A> dir momé&sis.ltr 


MS-DOS searches for the file MOM&SIS.LTR on the current drive 


(A). Remember the MS-DOS prompt always tells you the current 
drive. 


Note: You do not have to identify a drive letter if the file you 
want to use is on the current drive. 


Often, you need to specify a file on a drive other than the current 
drive. If this is the case, you need to specify the drive. For 
example, to display a file on drive B when drive A is the current 
drive, type: 


A> type b:thisfile 


The drive letter and the colon are called the drive specifier Always 
type the colon (:) after the drive letter. Do not put any spaces 
between the drive letter, colon, filename, period, and extension. 


To find out about using directories on a drive, see Chapter 3, 
Starting MS-DOS. 
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In this chapter, you will learn how to start your computer with 
MS-DOS and about some of the basic techniques you will need to 
work with your operating system. If you have used MS-DOS 
before, most of the information in this chapter will be familiar to 
you. Regardless of your experience with MS-DOS, it is a good 
idea to review each section in this chapter to be sure that you 
understand how to use MS-DOS with your computer. 


If you have a fixed disk drive in your computer, this chapter 
provides you information about setting up MS-DOS ona fixed 
disk and some tips on using this type of disk drive. If your fixed 
disk contains an earlier version of MS-DOS, you can replace it 
with Version 3.2 by following the procedure in the Upgrading 
MS-DOS section of this chapter. 


Keyboards 


The AT&T PCs use three different keyboards as shown below and 
on the following page. 


Model 301 Keyboard 
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Model 101 Keyboard 
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Inserting Diskettes 

To insert a 5%4-inch diskette properly: 
Remove the diskette from its paper sleeve. 
Open the diskette drive door. 


Slide the diskette into drive A with the label side up and 
towards you. Do not force or bend the diskette. 


4 — Shut the drive door carefully by moving its lever down 
and to the left. 
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Loading MS-DOS 
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If Your Computer Is OFF 


1 


Insert your working copy of the MS-DOS System 
Diskette into drive A and shut the drive door. 


Turn on your computer. 


A few seconds elapse as the system checks itself. The 
more memory in your computer, the longer this check- 
out period lasts. The following messages appear on 
your screen (the exact wording or sequence may vary 
depending on your computer): 


Resident Diagnostics 
Vers X.xXx 

CPU (1286) Pass 
ROM Module Pass 
DMA Timer Pass 
DMA Control Pass 
Interrupts Pass 
640 kb RAM Pass 
RT Clock Pass 
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If Your Computer Is ON 


1 


Insert your working copy of the MS-DOS System 
Diskette into drive A and shut the drive door. 


Press and hold down CTRL, ALT, and DEL (the system 
reset keys) and then release them. 


Note: Instead of pressing these keys, you can press 
the RESET button located at the bottom right-hand 
corner on the front of your computer just below the 
diskette drive. 


The screen displays diagnostic messages similar to the 
following: 


Resident Diagnostics 
Vers X.XX 


CPU (i286) Pass 
ROM Module Pass 
DMA Timer Pass 
DMA Control Pass 
Interrupts Pass 
640 Kb RAM Pass 
RT Clock Pass 
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The diskette drive light comes on while MS-DOS is 
being read into memory. 
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When MS-DOS Is Ready: The Prompt 


After MS-DOS is loaded into memory (a process called booting the 
system), your screen looks similar to this: 


Resident Diagnostics 


vers X.XX 

CPU (i286) Pass 
ROM Module Pass 
DMA Timer Pass 
DMA Control Pass 
Interrupts Pass 
640 kb RAM Pass 
RT Clock Pass 


Fixed Disk 1 Ready 
Floppy (A:) Ready 


AT&T Personal Computer MS-DOS Version 3.20 
Copyright (c) 1986 by AT&T, all rights reserved 


A> 


The A> on the screen is the MS-DOS prompt. (The letter of the 
prompt may vary, depending on which disk drive is currently 
active.) Whenever this prompt appears, you know that MS-DOS 
is ready for you to enter a command. 


Right after the prompt, you'll see a blinking underline or 
rectangle. This is the cursor. When you type commands or 
respond to questions displayed on the screen, the moving cursor 
indicates where the next character will appear. 
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Entering Commands 


—_—_—_—_—_—_—_— 


To make your computer perform a task, you must tell it what to 
do. This is called entering a command. The various MS-DOS 
commands perform different tasks such as displaying a list of files 
ona diskette (the DIR command), or making a duplicate of a 
diskette (the DISKCOPY command). 


Most MS-DOS commands do one task. You tell your computer to 
do "this" or "that" with a single command. 


To give MS-DOS a command: 


1 Wait until the prompt appears. 
2 Enter the command name and any other information 


required, such as a drive letter or filename. For 
instance, in the command line: 


type january.doc 


TYPE is the command name and JANUARY.DOC is the 
filename on which the command works. 


3 Press RETURN and the command procedure begins. 
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Entering an MS-DOS command is easy. Here are some simple 
tules: 


* Enter a command in upper-case or lower-case letters or a 
combination of both. 


* Use a blank space to separate the items on the command 
line from one another. 


* Type the command name first. 


° Always press RETURN after typing the command line. 
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If You Make a Mistake 


When you type a command, you might make a typing mistake. 
You can correct an error two ways. You can press BACKSPACE, 
which erases one character at a time as it moves the cursor to the 
left, then retype your input. You can also use the left arrow (—) 
key to move the cursor to the left and make the necessary change. 
(You can find a complete explanation of the cursor-movement 
keys in your AT&T PC user's guide.) 


3-13 


Starting MS-DOS 


Stopping the Screen To Read It 


When the screen fills up with information, new information 
appears at the bottom, pushing what is at the top "up" and 
causing it to disappear from view one line at a time. This process 
is called scrolling. Some MS-DOS commands (for example, DIR 
and TYPE) cause text to be displayed on the screen at such a rapid 
rate that the information may be scrolled out of sight before you 
get a chance to read it. Press CTRL-S to stop the display so you 
can read what is on the screen. Press any key to continue 
displaying information. 
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Printing What Is on the Screen 


You may want to have a printed copy of what is displayed on the 
screen. For example, you may need a copy of a form or just one 
piece of information from a file. 


If you have a printer attached to your computer, you can get an 
exact copy of what is displayed on the screen by pressing 
SHIFT-PrtSc . 


If you are working with graphics, you must have previously 


typed the GRAPHICS command and must be using an AT&T 473 
or compatible graphics printer. 


2 ‘AtsT 


ica | 
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The Default Drive 


The default drive is the disk drive identified by the letter 
displayed in the MS-DOS prompt. The "A" in the A> prompt, for 
example, means that diskette drive A is the default drive. Unless 
you specify another drive (B or C for example), MS-DOS 
automatically searches the diskette in drive A to locate and 
execute commands you type. For example: 

A> dir 
searches drive A for a directory of files. Since no drive is 
specified, the default drive A is assumed. However: 

A> dir b: 
searches drive B for a directory since drive B is specified. 
It is possible to change the default drive in the prompt. Type 
the new drive designation letter and follow with a colon. 
For example: 


A>b: 


When you press RETURN after this command, the new prompt 
appears: 


B> 


To find a directory on a diskette in drive A, you would now have 
to type: 


B>dir a: 
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Creating Working Diskettes 


As you learned in Chapter 2, it’s good idea to make working 
copies of your program diskettes as soon as you get them. Use 
the copies for daily work and store the originals in a safe place. 
You'll use the DISKCOPY command (explained in Chapter 4) to 
create working diskettes of the three diskettes supplied with this 
user guide. To create your working program diskettes, you'll 
need the following: 


° MS-DOS System Diskette, MS-DOS Supplemental 
Programs Diskette, and MS-DOS/AT&T Help Diskette, all 
located in the plastic pocket at the back of this guide. 
They are called source diskettes in the procedures below. 


° Three blank—or target—diskettes (of the same type as the 
program diskettes) that will become the copies. 


Note: DISKCOPY will also format the target diskette 
if it has not already been formatted. 


With a Single-Diskette-Drive Computer 
To create working diskettes with a single-diskette-drive computer 


with or without a fixed disk: 


1 Insert the MS-DOS System Diskette into drive A. 


2 ~~ Type: 
diskcopy a: b: 


and press RETURN. 
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TT 
This message appears: 


Insert source diskette in drive A: 
Strike any key when ready 


3 Leave the MS-DOS System Diskette in drive A if you are 
copying it; otherwise, remove it from drive A and insert 
either the MS-DOS Supplemental Programs Diskette or 
the MS-DOS/AT&T Help Diskette, depending on which 
one you want to copy. 


4 Press any key 


The in-use light comes on while the diskette is being 
read. When the computer has read the entire source 
diskette (or as much of it as can fit in memory), this 
message is displayed: 


Insert target diskette in drive A 
Strike any key when ready 


5 Remove the source diskette, insert the target diskette, 
and press any key. The light is on while the copy is 
being written. Depending on the amount of memory in 
your computer, you may be required to exchange 
diskettes several times until you see: 


Copying complete 


Copy another (¥/N)? 
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Remove the target diskette, prepare an appropriate label, 
apply the label to the diskette, and store it in its paper 
sleeve. 


6 If you have another diskette to copy, type: 
y (for yes) 


and repeat steps 3 through 5. You do not have to press 
RETURN. 


If you are finished copying the three program diskettes, 
type: 


n (for no) 


With a Two-Diskette-Drive Computer 


To create working diskettes with a two-diskette-drive computer: 


1 __ Insert the MS-DOS System Diskette into drive A. 


2 Type: 
diskcopy a: b: 


and press RETURN. 
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This message appears: 


Insert source diskette in drive A: 
Insert target diskette in drive B: 
strike any key when ready 


Leave the MS-DOS System Diskette in drive A if you are 
copying it; otherwise, remove it from drive A and insert 
either the MS-DOS Supplemental Programs Diskette or 
the MS-DOS/AT&T Help Diskette, depending on which 
one you want to copy. 


Insert the target diskette into drive B, and press any key 
when ready. If the target diskette is not formatted, or is 
formatted differently from the source diskette, 
DISKCOPY will display: 


Formatting while copying 


The lights on drives A and B go on and off as the 
copying proceeds. Do not open either drive door at any 
time during the process. DISKCOPY is complete when 
the following appears: 


Copying complete 
Copy another (¥/N)? 
Remove the target diskette, prepare an appropriate label, 


apply the label to the diskette, and store it in its paper 
sleeve. 
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5 If you have more diskettes to copy, type: 
y: 


and repeat steps 3 and 4. You do not have to press 
RETURN. 


If you are finished copying the three program diskettes, 
type: 
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Using a Fixed Disk Drive 


If your computer is equipped with a fixed or "hard" disk drive, 
you must carefully consider how best to use the disk before you 
prepare it to receive program and data files. 


Fixed Disk 


The basic strategy for handling any size fixed disk (as small as 
10 Mb and as large as 128 Mb) is to divide up its storage space 
into one to four areas or logical drives that MS-DOS will label C:, 
D:, E:, and F:, as necessary. This is called partitioning the fixed 
disk, and each of these logical drives is called a partition. 


Generally, a partition can be used by only one operating system. 
If you plan to use more than one operating system, you must 
create a partition in which each will reside. 
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Some considerations are: 


° How many people will be using this computer? Other 
users may want to use another operating system. 


You can partition the fixed disk for other operating 
systems later. However, you must perform several steps 

to move existing files to diskettes, then reformat and 
partition the fixed disk, before you can replace the existing 
files back into the MS-DOS partition. Rather than take 
this approach, it is better to try and anticipate your need 
for other operating systems and partition the disk 
accordingly now. 


Despite the seemingly unlimited amount of storage 
available with a fixed disk, partitioning the disk for two or 
more operating systems divides the available space. Be 
certain that having more than one operating system is 
what you want. 


When you set up a fixed disk for MS-DOS, you can create three 
types of partitions: 


* One and only one MS-DOS partition, which contains a 
working copy of MS-DOS and can also contain MS-DOS 
programs and data. 


* One or more DOS data partitions, which can hold MS-DOS 
programs and data but not the MS-DOS system itself. 


© One or more non-DOS partitions for use with other 
operating systems. 
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Once you partition the fixed disk, you must restart (reboot) the 
computer to make MS-DOS set the drive letter names (C:, D:, E:, 
etc.) for the MS-DOS and any DOS data partitions. You must also 
format each partition separately, transferring MS-DOS to the 
MS-DOS partition which is always drive C:. 
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Automatically Setting Up a Fixed Disk 
ss 


You may choose to use a program called INSTLDOS.EXE on your 
MS-DOS System Diskette to help you set up your fixed disk to 
contain MS-DOS Version 3.2. The program can automatically 
create and format an MS-DOS partition on your fixed disk for 
you. Alternatively, you may choose to create and format an 
MS-DOS partition and other partitions as well by following the 
procedures described in the next section, Partitioning Your Fixed 
Disk. To use the INSTLDOS.EXE program: 


1 Insert your working copy of the MS-DOS System 
Diskette in drive A, and start, or restart, MS-DOS, 
depending on whether your computer is off or on. 


2 Type: 
A> instldos 


and press RETURN. 


The menu shown at the top of the next page is 
displayed. 
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Welcome to the AT&T Installation Procedure 
for MS-DOS 3.2. 


If your fixed disk system has never been used 
before, this procedure will put MS-DOS 3.2 on it. 
If your fixed disk system has an earlier version 


of MS-DOS on it, this procedure will upgrade it 
to version 3.2. 


At any prompt, ‘Enter choice:’, the default choice 
will be displayed. Press RETURN to accept the 
default, or enter the number of your choice. 


You may exit this installation procedure, whenever 
the screen is static, by holding down the CTRL key 
while pressing the BREAK key. 


Main Menu: 


1. Do not run INSTLDOS just start 
MS-DOS 3.2. 


2. Begin installing MS-DOS 3.2 on a 
fixed disk that has never been used before. 


3. Continue installing MS-DOS 3.2 on a 
previously unused fixed disk. 


4. Upgrade an earlier version of MS-DOS 
on your fixed disk to version 3.2. 


Enter choice: 4 


* Option 1 will return you to the MS-DOS prompt. 
* Option 2 will: 


— Run an MS-DOS program called FDISK to 
create an MS-DOS Version 3.2 partition on 
your fixed disk. 
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— Restart your system, asking you to restart the 
INSTLDOS program and select Option 3 from 
the Main Menu. 


Note: You must execute Option 2 before 
you can successfully execute Option 3. 


° Option 3 will: 


— Run an MS-DOS program called FORMAT to 
prepare the MS-DOS Version 3.2 partition on 
your fixed disk (using Option 2) to receive 
files. 


— Copy the files from your MS-DOS Version 3.2 
of the MS-DOS System Diskette, MS-DOS 
Supplemental Programs Diskette, and 
MS-DOS/AT&T Help Diskette to your fixed 
disk. 


© Option 4 will: 


— Replace files on your fixed disk with MS-DOS 
Version 3.2 files having the same names on 
your MS-DOS System Diskette and MS-DOS 
Supplemental Programs Diskette. 


— Add new files in MS-DOS Version 3.2 from 
your MS-DOS System Diskette, MS-DOS 
Supplemental Programs Diskette, and 
MS-DOS/AT&T Help Diskette to your fixed 
disk. 


Note: Choose Option 4 only if you 
already have an earlier version of 
MS-DOS installed on your fixed disk and 
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you want to upgrade it to MS-DOS 
Version 3.2. For more information, see 


Automatically Upgrading a Fixed Disk 
later in this chapter. 


3 Type: 


and press RETURN. 


From this point on, you will be guided by messages displayed on 
your screen. 
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Partitioning Your Fixed Disk 
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Partitioning allows an operating system to occupy space tailored 
to its exact needs for proper operation. Each operating system 
that can be used with a fixed disk has its own commands for 
placing it on the disk. 


Planning Partitions 


You must partition your fixed disk even if MS-DOS is the only 
operating system you are using. You can have only one MS-DOS 
partition; you will always need to create the MS-DOS partition, 
no matter what size disk you have. If your fixed disk is larger 
than 32 Mb, you will also need to create at least one DOS data 
partition to utilize the entire disk because 32 Mb is the maximum 
size partition, or logical disk, that MS-DOS recognizes. Creating 
only the MS-DOS partition on a disk larger than 32 Mb, would 
leave a large amount of unused space on the disk. The DOS data 
Partition, in effect, allows MS-DOS to recognize space beyond 

32 Mb, thus making maximum use of the disk. 


Note: Versions of MS-DOS earlier than 3.2 will not recognize 
any type partition located beyond 32 Mb or any DOS data 
partition, regardless of its location. 


If your fixed disk is smaller than 32 Mb, you will need to create 
only the MS-DOS partition, although you can create a DOS data 
partition if you want to store MS-DOS files and programs as 
though they were on two separate disks. The maximum number 
of partitions you can create on a fixed disk is four, including the 
required MS-DOS partition, DOS data partitions, and 
non-MS-DOS partitions. 


If you’re using another operating system, give it the space it 
requires. Refer to the operating system’s user guide for 


Starting MS-DOS 


instructions on placing it in its own non-MS-DOS partition on a 


fixed disk. 


Determining Partition Size 


The illustration below represents one way that MS-DOS can set 
up multiple partitions on a fixed disk. A fixed disk consists of a 
stack of rigid platters containing magnetic media and one 
read/write head per each usable side of a platter. The platters are 
attached to one another so that they rotate as a unit. Formatting a 
fixed disk creates tracks and sectors on each of the platters. (Refer 
to the section Tracks, Sectors, and Compatibility in Chapter 2 for 
more information about tracks, sectors, and read/write heads.) 


CYLINDER O 
/ovunoer 
/ CYLINDER 980 
y 


posC@ > D: 
DATA PARTITION 


MS-DOS PARTITION 


The set of tracks on all of the usable platter sides that can be read 
all at once without moving the read/write heads is called a 
cylinder. When you partition a fixed disk, you tell the system to 
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consider a specified number of cylinders as a logical disk, or 
partition. 


When you create an MS-DOS partition or DOS data partition, you 
will be prompted to enter a partition size and a starting cylinder 
number. You can enter a number or use the default values 
shown in brackets after the prompts. For example: 


Enter partition size............: [ 770) 
Enter starting cylinder number..: [ 0) 


The default value shown (the maximum available space fora 
partition) is either the largest amount of uninterrupted free 
cylinder space on the fixed disk or the number of cylinders 
equivalent to 32 Mb, whichever is smaller. The number of 
cylinders that hold 32 Mb can vary depending on the fixed disk 
used. The FDISK program that partitions your disk also computes 
the number of cylinders that translate to 32 Mb for a particular 
disk. 


Instead of using the default size, you may want to enter a smaller 
size for the MS-DOS partition so it occupies less space. This 
would set aside more available space for the DOS data partition 
and a non-MS-DOS partition for another operating system if you 
anticipate using one. You cannot enter a number larger than the 
default size. 


When you are using MS-DOS and have more than one fixed disk, 
only the first disk needs the MS-DOS partition. The others could 
have all DOS data partitions. 
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Accessing the Partitioning Menu 


The MS-DOS program that performs the partitioning of your 
fixed disk is FDISK.COM. It is on the MS-DOS System Diskette. 


Note: The INSTLDOS program (described in Automatically 
Setting Up a Fixed Disk earlier in this chapter) automatically 
runs FDISK for you. Use the FDISK procedure only if you do 
not use INSTLDOS. 


To use the FDISK program: 


1 Start the computer with your working copy of the 
MS-DOS System Diskette in drive A. 


2 + When the A> prompt appears, type: 
fdisk 


and press RETURN. 


The FDISK Options menu appears on the screen (shown 
on the top of the next page). 
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1. Create 


2. Create 
3. Change 
4. Delete 
5. Delete 


7. Select 
Enter choic 


FDISK Options 


AT&T FDISK Utility version 2.0 


Current Fixed Disk: 1 


Choose one of the following: 


MS-DOS Partition 
DOS-DATA Partition 
Active Partition 
MS-DOS Partition 
DOS-DATA Partition 


6. Display Partition Data 


Next Fixed Disk 
(1 


Press Esc to return to DoS. 


Note: The message: 


Current Fixed Disk:1 


and the menu item: 


7. Select Next Fixed Disk 


appear only when you have a second fixed disk 
drive connected to your computer. When you select 
item 7, the number 1 in the 


Current Fixed Disk: 
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field changes to 2 as shown below: 
Current Fixed Disk: 2 


The FDISK command allows you to: 


* Create one MS-DOS partition, specifying its size and 
starting position on the disk. 


Create one or more DOS data partitions, specifying the 
size and starting position of each one. 


Change the active partition used when the computer is 
started (either to MS-DOS partition or non-DOS partition). 


Delete the MS-DOS partition. 
Delete a DOS data partition. 


Display a partition data table showing the partition 
number, status, type, starting and ending positions on the 
disk, and size. 


Perform the above operations on either of two fixed disks, 
if you have added an extra fixed disk. 


Creating the MS-DOS Partition 


1 Bring the FDISK Options menu to the screen, as 
described in Accessing the Partitioning Menu earlier in 
this chapter, if you have not already done so. 


Starting MS-DOS 


Press RETURN. 


The menu item: 
1, Create MS-DOS Partition 


is preselected. You do not need to type a 1. 


The screen display is similar to: 


AT&T FDISK Utility version 2.0 


Create DOS partition 


Current Fixed Disk: 1 


No partitions defined. 


Total disk space is 980 cylinders 
Maximum available space for a partition 


is 770 cylinders at cylinder 0 
Enter partition size.......... wot E7703 
Enter starting cylinder number..: [ 0) 


Press Esc to return to FDISK Options 
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Note: The total disk space and default values shown 
in the brackets may differ from those on your screen 
depending on the size of your fixed disk. 


If the fixed disk already has an MS-DOS partition, the 
screen displays the table of partition data (shown in 
Displaying the Partition Table later in this chapter) and 
the message: 


Fixed disk already has a DOS partition 


If you have more than one fixed disk, you can display 
information for each disk after you change to the next 
disk by selecting item 7. Select Next Fixed Disk from 
the FDISK menu. 


3 Respond to the prompt: 


Enter partition size ...... 


by typing the number of cylinders you want to allocate 
for MS-DOS. Enter the number and press RETURN, or 
use the default value (the number in the brackets) by 
pressing RETURN. 


The default partition size is the size of the largest 
uninterrupted free space, not exceeding 32 Mb, on the 
disk. If you choose to specify a size other than the 
default size, it must be smaller than the default size; 
otherwise, an error message is displayed. 
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In the sample screen shown in Step 2, there are 980 
cylinders of total disk space. Of this space, a maximum 
of 770 cylinders may be used for one partition. The 770 
cylinders are approximately equivalent to 32 Mb. Since 
no other partitions have been defined yet, the maximum 
size that MS-DOS recognizes is made available. You 
could for example: 


*° Press RETURN to assign all 770 cylinders to the 
MS-DOS partition. The remaining 210 cylinders 
(980-770 = 210) could then be used for a DOS 
data partition (see Creating a DOS Data 
Partition later in this chapter) or another 
operating system. 


or 


¢ Enter a number smaller than 770 (for example, 
300), thus freeing up cylinder space to use for 
DOS data partitions and a non-MS-DOS partition 
for another operating system. 


In this example, you might: 


¢ Assign 40 percent of the total disk space to the 
MS-DOS partition rounded off to the nearest 100 
cylinders. This would be 980 x .40 = 392 or 400 
cylinders 


* Assign 25 percent of the total disk space to the 
DOS data partition and round off to the nearest 
100 cylinders. This would be 980 x .25 = 245 or 
200 cylinders. 
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* Use the remaining cylinder space for a 
non-MS-DOS that you would create by using the 
equivalent of the FDISK program for the other 
operating system. 


No matter what percentages you decide to use, you must 
decide on how best to allocate your disk space to 
partitions. 


Note: An MS-DOS partition is required only on the 
first fixed disk to boot MS-DOS. 


Respond to the prompt: 


Enter starting cylinder number ... 


by either pressing RETURN to accept the default cylinder 
number shown, or entering another 3-digit number. The 
default starting cylinder number is the first cylinder of 
the partition referenced by the default partition size. 
You can determine the best location for the size 
partition you want by looking at the table of partition 
data displayed above the prompts to enter partition size 
and starting cylinder number. 


Respond to the prompt: 


Press ESC to return to the FDISK Options 


by pressing ESC. The FDISK Options menu is 
displayed. 
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6 Make the MS-DOS partition active by following the 


steps in Changing the Active Partition later in this 
chapter. 


Making the partition active enables you to boot MS-DOS 
from it. You will return to the FDISK Options menu 
when you complete the steps. 


7 Press ESC. 


The following message is displayed: 


NOTICE! If you have just created a new MS-DOS 
and/or any DOS-DATA partitions, when you 

return to DOS, use the FORMAT utility to format 
the new MS-DOS and each new DOS-DATA partition 
you created, before attempting to write data 

to these partitions 


System will now reboot 


Insert DOS diskette in drive A: 
Press any key when ready 


8 Make sure you have the MS-DOS System Diskette 
inserted in drive A. 


9 Press any key. 


The system reboots and the resident diagnostic messages 
are displayed followed by the MS-DOS prompt. 
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11 


12 


To format the MS-DOS partition and transfer the 
MS-DOS hidden system files to that partition on the 
fixed disk, type: 


A> format c: /s 


and press RETURN. The following messages are 
displayed: 


WARNING,ALL DATA ON NON-REMOVABLE DISK 
DRIVE C: WILL BE LOST! 


Proceed with Format (¥/N)? 


Type: 


and press RETURN. 
When the format is complete, type: 
A>copy *.* c: 


to copy the MS-DOS external commands from the 
MS-DOS System Diskette to the MS-DOS partition on 
your fixed disk. 
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13 Remove the MS-DOS System Diskette from drive A. 


14 Insert the MS-DOS Supplemental Programs Diskette in 
drive A and type: 


A> copy *.* c: 
Your fixed disk is now ready to be used. 


Creating a DOS Data Partition 


You do not need to create a DOS data partition to run MS-DOS; 
but you will need to create one if your fixed disk is larger than 
32 Mb and you want to use all the available disk space. Here are 
some more points to keep in mind: 


¢ You can create a DOS data partition on any size fixed disk 
as long as you leave room for it. 


¢ You may want to create DOS data partitions to group 
related data files together. 


¢ You can create multiple DOS data partitions; you might. 
for example, have the required MS-DOS partition, three 
DOS data partitions, and no non-MS-DOS partitions. 


° MS-DOS will automatically assign drive letters to each 
DOS data partition you create (and to the MS-DOS 
Partition as well) when you boot the system. 


° You cannot transfer MS-DOS system files to a DOS data 
partition or make a DOS data partition active (only the 
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MS-DOS partition or a non-MS-DOS partition can be made 
active); therefore, you cannot boot MS-DOS from this 
partition. 


To create a DOS data partition: 


1 Bring the FDISK Options menu to the screen, as 
described in Accessing the Partitioning Menu earlier in 
this chapter, if you have not already done so. 


2 — Select the menu item: 
2. Create DOS-DATA Partition 


by typing 2 and pressing RETURN. 


The screen display is similar to that shown at the top of 
the next page. 
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AT&T FDISK Utility version 2.0 


Create DOS-DATA Partition 


Current Fixed Disk: 1 


Partition Status Type Start End Size 
1 A MS-DOS C) 299 300 


Total disk space is 980 cylinders 
Maximum available space for a partition 
is 680 cylinders at cylinder 300 


Enter partition size............. ( 680) 


Press Esc to return to FDISK Options 


Note: The total disk space shown may differ from 
that on your screen depending on the size of your 
fixed disk. The partition information and the 
default value in brackets vary depending on the size 
of other partitions created previously and the total 
disk space. 


3. Respond to the prompt: 


Enter partition size ............: 
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by typing the number of cylinders you want for your 
DOS data partition. Enter the number and press 
RETURN, or use the default value (the number in 
brackets) by pressing RETURN. The default partition 
size is the size of the largest uninterrupted free space, 
not exceeding 32 Mb, on your disk. If you choose to 
specify a size other than the default size, do not enter a 
number larger than the default value. 


The screen displays: 
Enter starting cylinder number... [ 300] 


Note: The default value shown may differ from that 
shown on your screen. Also, refer to Creating the 
MS-DOS Partition (Step 3) earlier in this chapter for 
an explanation of partition size. 


Respond to the prompt: 


Enter starting cylinder number ... 


by either pressing RETURN to accept the default value or 
entering another 3-digit number. The default starting 
cylinder number is the first cylinder of the partition 
referenced by the default partition size. You can 
determine the best location for the size partition you 
want by looking at the table of partition data displayed 
above the prompts to enter partition size and starting 
cylinder number. 
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The screen display is similar to: 


AT&T FDISK Utility version 2.0 


Create DOS-DATA Partition 


Current Fixed Disk: 1 


Partition Status Type Start End Size 
1 A MS-DOS ° 299 300 
2 N DOS-DATA 300 980 680 


Total disk space is 980 cylinders 
Maximum available space for a partition 
is 680 cylinders at cylinder 300 

Enter partition size. wisi .. C680) 
Enter starting cylinder number... [ 300] 


Press Esc to return to FDISK Options 


Note: The values shown may differ from those 
shown on your screen. 
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5 Respond to the prompt: 
Press ESC to return to the FDISK Options 


by pressing ESC. 
6 Press ESC again. 


The following message is displayed: 


NOTICE! If you have just created a new MS-DOS 
and/or any DOS-DATA partitions, when you 
return to DOS, use the FORMAT utility to 
format the new MS-DOS and each new 

DOS-DATA Partition you created, 

before attempting to write data to these 
partitions. 


System will now reboot 


Insert DOS diskette in drive A: 
Press any key when ready 


7 Make sure you have the MS-DOS System Diskette 
inserted in drive A. 


8 Press any key. 


The system reboots and the resident diagnostic messages 
are displayed followed by the MS-DOS prompt. 
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To format the DOS data partition on the fixed disk, type: 


A> format d: 


and press RETURN. The following messages are 
displayed: 


WARNING, ALL DATA ON NON-REMOVABLE DISK 
DRIVE D: WILL BE LOST! 


Proceed with Format (¥/N)? 
Type: 
a 


and press RETURN. 


When FORMAT is finished, the DOS data partition will 
be ready for use. 


Note: If you are creating the second DOS data 
partition, substitute the letter E for the letter D in 
the FORMAT command above. If you are creating 
the third DOS data partition, substitute F, and so on. 
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You determine what the drive letter is according to the 
following: 


* The MS-DOS partition is always drive C, regardless 
of its location. 


* DOS data partitions are assigned drive letters in 
ascending order, according to their positions on the 
table of partition data. 


For example, the table of partition data might look like 


this: 

Partition Status Type Start End Size 
1 N DOS-DATA 0 199 200 
2 N DOS-DATA 200 399 200 
3 A MS-DOS 400 499 100 
4 N DOS-DATA 500 699 200 


In this example, the drive letters would be: 


¢ C: for Partition 3 (the MS-DOS partition) 

© D: for Partition 1 

° E: for Partition 2 

¢ F: for Partition 4. 
Note: The first drive letter on a second fixed disk 
depends on how many partitions are on the first fixed 
disk. Use of volume labels will help you keep track of 


the fixed disk drives (see the MS-DOS command LABEL 
described in Chapter 5). 
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Changing the Active Partition 


You must make the MS-DOS partition active before the first time 
you boot the system from it. After that, you only need to make a 
partition active when you have installed two operating systems 
and you want to switch between them. You cannot make a DOS 
data partition active. 


To change the active partition: 


1 Bring the FDISK Options menu to the screen, as 
described in Accessing the Partitioning Menu earlier in 
this chapter, if you have not already done so. 


2 — Select the menu item: 
3. Change Active Partition 


by typing 3 and pressing RETURN. 


The screen display is similar to that shown at the top of 
the next page. 
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AT&T FDISK Utility version 2.0 


Change Active Partition 


Current Fixed Disk: 1 


Partition Status Type Start End Size 
1 N MS-DOS 0 299 300 


Total disk space is 980 cylinders 


Enter the number of the partition you want 
to make active...........-2eeeee02 C1) 


Press Esc to return to FDISK Option. 


Respond to the prompt: 


Enter the number of the partition you want 
to make active. 


by typing the number of the partition that holds the 
operating system you want to start your computer. If 
you are using only one operating system such as 
MS-DOS as shown in the sample screen in Step 2, just 
press RETURN. The default partition, identified by the 
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number in the brackets, will be made active. The screen 
display changes and looks similar to: 


AT&T FDISK Utility version 2.0 


Change Active Partition 


Current Fixed Disk: 1 


Partition Status Type Start End Size 
cI A MS-Dos t) 299 300 


Total disk space is 980 cylinders 
The current active partition is 1 


Partition 1 made active. 


Press Esc to return to FDISK Options 


An A appears under Status indicating that partition 1 is 
now active. 


4 Press ESC to return to the FDISK Options menu. 


Deleting the MS-DOS Partition 


You may want to delete the MS-DOS partition to free up space on 
your fixed disk for another operating system partition, change its 
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size, or change its size to add a DOS data partition. However, 
you must be careful. Deleting this partition destroys the contents 
of this part of the fixed disk. You will not be able to boot your 
computer with MS-DOS from the disk; rather, you will have to 
start the computer using the MS-DOS System Diskette inserted in 
drive A. (If you have another operating system installed and 
made active, you can boot the computer from it.) Before you 
delete the MS-DOS partition, be sure to make back-up copies of 
the files it holds. Use the MS-DOS command BACKUP (described 
in Chapter 5) before you continue. 


Note: Deleting partitions, whether MS-DOS or DOS data 
Partitions (as explained in the next section), may cause the 
drive letters of the remaining partitions (if any) to change. If 
partitions are deleted (or created) on a first fixed disk, the 
drive letters on a second fixed disk, as well as the first, may 
be affected. Deleting (or creating) partitions on a second fixed 
disk can affect the drive letters of the other partitions on that 
disk only. 


To delete the MS-DOS partition: 


1 Bring the FDISK Options menu to the screen, as 
described in Accessing the Partitioning Menu earlier in 
this chapter, if you have not already done so. 


2 Select the menu item: 
4. Delete MS-DOS Partition 


by typing 4 and pressing RETURN. 
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The screen display is similar to: 


AT&T FDISK Utility version 2.0 


Delete DOS Partition 


Current Fixed Disk: 1 


Partition Status Type Start End Size 
4 N DOS-DATA 100 349 250 
2 N DOS-DATA 500 599 100 
3 A MS-DOS 774 873 100 


Total disk space is 980 cylinders 
The current active partition is 3 


Warning! Data in the DOS partition 
could be lost. Do you wish to 
continue.... 


Press Esc to return to FDISK Options 


3° Do one of the following: 


* To cancel the delete operation if you change your 
mind, press RETURN to accept the default n in 
response to the warning prompt, or press ESC to 
return to the FDISK Options menu. 
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* To proceed with the delete operation, type: 


y 


and press RETURN. 


The MS-DOS partition is deleted. You see the 
following message. 


System will now reboot 


Insert DOS diskette in drive A: 
Press any key when ready 


4 Make sure you have the MS-DOS System Diskette 
inserted in drive A and press any key. 


Deleting a DOS Data Partition 


You may want to delete a DOS data partition to free up space on 
your fixed disk for another partition. However, you must be 
careful. Deleting this partition destroys the files it contains. Be 
sure this is what you want to do. 


To delete a DOS data partition: 


1 Bring the FDISK Options menu to the screen, as 
described in Accessing the Partitioning Menu earlier in 
this chapter, if you have not already done so. 
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2 Select the menu item: 
5. Delete DOS-DATA Partition 


by typing 5 and pressing RETURN. 


The screen display is similar to: 


AT&T FDISK Utility version 2.0 


Delete DOS-DATA Partition 


Current Fixed Disk: 1 


Partition Status Type Start End size 
1 N DOS-DATA 100-349-250 
2 A MS-DOS 350 499 150 
3 N DOS-DATA 500 599 100 


Total disk space is 980 cylinders 


Enter the number of the DOS-DATA 
Partition you wish to delete.... 


Press Esc to return to FDISK Options 
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3 Do one of the following: 


* To cancel the delete operation if you change 
your mind, press ESC. 


To proceed with the delete operation, type 
the number of the DOS data partition you 
want to delete and press RETURN, or press 
RETURN if the default partition, indicated by 
the number in the brackets, is the one you 
want to delete. 


If you press RETURN, the screen display is similar to 
that shown at the top of the next page. 
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Warning! 
could be 
continue. 


AT&T FDISK Utility version 2.0 


Delete DOS-DATA Partition 


Current Fixed Disk: 1 


Partition Status Type Start End Size 
1 N DOS-DATA 100 349 250 
2 A MS-DOS 350 499 150 
3 N DOS-DATA 500 599 100 


Total disk space is 980 cylinders 


Enter the number of the DOS-DATA 
Partition you wish to delete..........: [1] 


Press Esc to return to FDISK Options 


Data in the DOS DATA partition 
lost. Do you wish to 


4 Do one of the following: 


To cancel the delete operation if you change 
your mind, press RETURN to accept the 
default n in response to the warning prompt, 
or press ESC to return to the FDISK Options 
menu. 
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* To proceed with the delete operation, type: 


and press RETURN. 


When you type y and press RETURN, the partition 
you specified in Step 3 is deleted and you see the 
following message: 


System will now reboot 


Insert DOS diskette in drive A: 
Press any key when reaay 


5 Make sure you have the MS-DOS System Diskette in 
drive A, and press any key. 


Displaying the Partition Table 


The table of partition data displays how many and what types of 
partitions you have, where they are located, and how much 
cylinder space they occupy. 


To display the partition table: 


1 Bring the FDISK Options menu to the screen, as 
described in Accessing the Partitioning Menu earlier in 
this chapter, if you have not already done so. 


Starting MS-DOS 


soo 
2 Select the menu item: 
6. Display Partition Data 


by typing 6 and pressing RETURN. 


The screen display is similar to: 


AT&T FDISK Utility version 2.0 


Display Partition Information 


Current Fixed Disk: 1 


Partition Status Type Start End Size 
1 N DOS-DATA 100 349 250 
2 N DOS-DATA 500 599 100 
a A MS-DOS 774 873 100 


Total disk space is 980 cylinders 
The current active partition is 3 


Press Esc to return to FDISK Options 
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The Display Partition Information (or "Partition Map") 
screen shows: 


Current Fixed Disk: — either 1 or 2. This line 
appears only if you have more than one fixed 
disk. 


Partition — the number of each partition you 
created. 


Status — the status of the partition, either N for 
nonactive or A for active. DOS data partitions 
will always be N. Only a partition that holds an 
operating system can be either active or 
nonactive; an active partition is the one that 
holds the operating system you want to use to 
run your computer. 


° Type — either MS-DOS for the MS-DOS 
operating system partition, DOS-DATA for the 
DOS data partition, or NON-DOS for another 
operating system. 


Start — the first cylinder of the partition. 


End — the last cylinder of the partition. 


Size — the number of cylinders making up the 
partition. 


Total disk space is — the total number of 
cylinders the fixed disk has. 


The current active partition is — the number of 
the partition that holds the operating system you 
are using. 
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3 Press ESC to return to the FDISK Options menu. 


Selecting the Next Fixed Disk 


This applies only when you have a second fixed disk connected to 
your computer. 


To select a second fixed disk: 


1 Bring the FDISK Options menu to the screen, as 
described in Accessing the Partitioning Menu earlier in 
this chapter, if you have not already done so. 


2 Select the menu item: 
7. Select Next Fixed Disk 


by typing 7 and pressing RETURN. 


The Current Fixed Disk: field on the screen changes 
from 1 to 2 as shown below: 


Current Fixed Disk: 2 


You will now operate with your second fixed disk drive. 


Note: To select the first fixed disk again, repeat this 
procedure. The Current Fixed Disk: field on the screen will 
change from 2 to 1. 
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Organizing Your Fixed Disk 


For new computer users, or users who haven’t used fixed disks 
before, putting all available disk storage to best use can pose a 
challenge. To help you, MS-DOS has the capability to create 
directories, storage areas on the fixed disk that hold other 
directories and files. 


Directories and Subdirectories 


When you format your fixed disk, MS-DOS creates a directory on 
it called the root directory. You can create your own directories, 
called subdirectories, placed under the root directory. If you have 
trouble picturing how something can be "under a root," think of 
an upside-down tree with its root in the air and its branches on 
the ground. This is what the MS-DOS directory structure is like. 
The root directory is the inverted tree’s root, and the 
subdirectories you create are the branches, growing down instead 
of up. 


The subdirectories you make divide the fixed disk into different 
storage areas, each of which you can use separately. You can 
create subdirectories within subdirectories, thus making a multi- 
level directory structure. 


A structure of subdirectories is much like organizing paper files 
ina file cabinet. Suppose you keep correspondence and other 
papers about projects you work on for the sales and engineering 
departments at your company, as well as other miscellaneous 
notes. You divide one drawer of your file cabinet into three 
sections, two of which have dividers you label SALES and ENG. 
You put your various work notes in the first front section, 
unlabeled. Inside the SALES and ENG sections you have three 
folders, one containing proposals, one product information, and 
one administrative memos. You label these folders PROP, 
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PRODINFO and ADMIN, respectively. This is how the file 
cabinet drawer and the corresponding MS-DOS directory 
structure would look: 


ROOT 

DIRECTORY 
5.008 

COMMAND FILES 


SUBDIRECTORIES 


SALES ENG 


PROP PROD INFO ADMIN PROP 
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The root directory corresponds to the file cabinet drawer, with 
the MS-DOS command files corresponding to your work notes. 
The SALES and ENG subdirectories correspond to the labeled 
section dividers, and the subdirectories within SALES and ENG 
correspond to the respectively labeled folders. The files in each 
subdirectory contain your information, just as your papers inside 
the folders do. 


Information files can also reside in subdirectories at any level. 
The SALES and ENG subdirectories, for example, could contain 
information files in addition to the subdirectories PROP, 
PRODINFO, and ADMIN. This means directories can contain 
other directories and files. You could go on and on (until you ran 
out of disk space, or until you reached the limit MS-DOS puts on 
the number of directory entries allowed) creating multiple levels 
of directories and files—subdirectories, sub-subdirectories, 
sub-sub-subdirectories, etc. 


Creating a Subdirectory 


If you have a large number of files, it’s a good idea to organize 
them into subdirectories. If you don’t use subdirectories, system 
performance can slow down when your computer looks for a file. 
Creating subdirectories establishes branches (called paths) 
MS-DOS can follow to speed up processing. 


The MKDIR or MD (make directory) command creates a 
subdirectory. You must supply a subdirectory name. For 
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example, to create two subdirectories named SALES and ENG on 
an otherwise empty fixed disk (identified as the C drive), type: 


C> mkdir sales 


and press RETURN. 


The C> prompt returns to the screen. Type: 
mkdir eng 


and press RETURN. 
The C> prompt returns to the screen. 


You can display these subdirectories by typing: 
dir 


The screen display is similar to: 


Volume in drive C has no label 
Directory of C:\ 


SALES <DIR> 06-15-86 
ENG <DIR> 06-15-86 
2 Files 350,549 bytes free 
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MS-DOS creates the subdirectories as files and identifies them as 
subdirectories by the <DIR> following their names. The 


\ (backslash) after the C: on the second line identifies the root 
directory. 


The Current Directory 


The current directory can be either the root directory or a 
subdirectory. MS-DOS keeps track of the current directory just as 
it does the current drive. 


The CHDIR or CD (change directory) command displays the 
name of the current directory. It is also used to change 
directories, as explained in the next section. To display the 
current directory, type: 


cd 


The screen displays: 


The current directory is the root directory identified by the 
backslash (\). Any command you type will apply to the root 
directory. 


Changing the Current Directory 


You can change the current directory to one of the subdirectories 
you created by using the CHDIR or CD (change directory) 
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command followed by the name of the subdirectory you want to 
be in. For example, type: 


cd sales 

and press RETURN. 

The C> prompt returns to the screen. Type: 
cd 

and press RETURN. 

The screen displays: 
Cc: \SALES 


The SALES subdirectory is now the current directory. Any 
command you type will apply to it. 


You can change from a subdirectory to the directory immediately 
above it by using the marker .. which represent the directory that 
contains the current directory. The current subdirectory is 
SALES. To change from the SALES subdirectory to the root 
directory, type: 


cd .. 


and press RETURN. 
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The C> prompt returns to the screen. Type: 
cd 


and press RETURN. 


The screen displays: 


This shows the current directory now to be the root directory, 
which is one level above the SALES subdirectory. 


Paths and Subdirectories 
When you are in the SALES subdirectory and you type: 


cd 
the screen displays: 
C: \SALES 


As mentioned earlier, the \ (backslash) identifies the root 
directory, and SALES identifies the subdirectory you are in. 
Together, with the drive letter C:, they make up the pathname of 
the directory. The pathname identifies the path MS-DOS follows 
to locate subdirectories. 


3-68 


Starting MS-DOS 


You can change from one directory to a subdirectory several 
levels below (or above) by specifying a path in the CD command. 
For example, to change from the root directory to the PROP 
sub-subdirectory under the ENG subdirectory, type: 

cd eng\prop 
and press RETURN. 
The C> prompt returns to the screen. Type: 

cd 
and press RETURN. 
The screen displays: 

C: \ENG\PROP 
You can also use a pathname to tell MS-DOS where to look fora 
file you have in any subdirectory. You type the pathname before 
the filename and separate them with a backslash. For example, 
from the root directory, to display a file containing a proposal 
you wrote in June in the PROP sub-subdirectory under the SALES 
subdirectory, type: 

type sales\prop\prop.jun 


and press RETURN. 
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The screen displays the contents of the PROP.JUN file in the 
PROP sub-subdirectory under SALES. 


Displaying the Contents of a Directory 


You use the DIR command to display the subdirectories and files 
that exist in the current directory. For example, assume that a 
file, called SALES.XYZ, exists in the root directory, and you type: 


dir 


The screen display is similar to: 


volume in drive C has no label 
Directory of C:\ 


SALES <DIR> 06-15-86 9:30a 
ENG <DIR> 06-16-86 9:30a 
SALES XYZ 24 06-15-86 9:51a 

2 Files 350,549 bytes free 


This shows the contents of the root directory to be the SALES and 
ENG subdirectories and the file SALES.XYZ. 


If you do not create subdirectories, the listing DIR gives of files in 
the root directory can be very, very long. When you are in the 
root directory, the DIR command shows you everything in the root 
directory. You can have several hundred files on the disk — and 
this is not too difficult to do — it is both time consuming and 
tedious to locate a specific file if you’ve forgotten its exact name 
and extension. 
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Removing Subdirectories 


As you create subdirectories, you will make a multi-level 
directory structure. At some point, you may no longer have use 
for a particular subdirectory. You might also want to reorganize 
your subdirectories by taking files from one, placing them into 
another, and then removing the old subdirectory. The RMDIR or 
RD (remove directory) command removes, or deletes, a 
subdirectory. You cannot remove a subdirectory that has files or 
other subdirectories in it. For example, assume you are in the 
ENG subdirectory, which contains a subdirectory ADMIN that has 
no files. To remove it, type: 


rmdir admin 


The subdirectory \ENG\ADMIN is removed. 


If the subdirectory you want to remove is not empty, you must 
first delete its files using the DEL command. For example, if 
ADMIN is not empty and you are in ENG, type: 


del admin\*.* 


where *.* specifies files with any filename and extension in 
ADMIN. 


Searching for Executable Files 


Executable files are programs whose filenames have the 
extensions, .COM, .EXE, or .BAT. You run an executable file by 
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typing the first part of its filename at the MS-DOS prompt. If an 
executable file is in a different subdirectory from the one you are 
currently using, you can always execute it by typing its pathname 
before the first part of its filename. 


For example, if the executable file SHIP.EXE is located in the BIN 
subdirectory of the root directory, the command: 


c> \bin\ship 


will always execute SHIP. However, you may find it 
inconvenient to type pathnames before commands. The PATH 
command lets you execute commands without specifying a 
pathname every time you type a command name. It creates a list 
of pathnames that MS-DOS searches whenever you enter a 
command name. An example is given on the next page. 


For more information, refer to the PATH command in Chapter 5. 


A Sample Multi-Level Directory 


The illustration on the next page shows how a fixed disk 
subdirectory structure might be set up. 
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In the root directory (\) you create three subdirectories: BIN, 
INTAPP, and ENGPA. 


* BIN is where you place all the MS-DOS external command 
files and other executable files that have a .COM or a .EXE 
extension. You will need to use the PATH command at 
the C> prompt or in an AUTOEXEC.BAT file to tell 
MS-DOS where to look for executable files. For example: 


PATH=C:\; C:\BIN 


searches for executable files in the root and BIN 
directories. 


INTAPP (meaning "Integrated Application") holds the 
program files for an application program that performs 
multiple functions such as spreadsheets, word processing, 
etc. It also has two subdirectories: SALES and COSTS. 
SALES has three subdirectories: PRODA, PRODB, and 
PRODC (PROD meaning "product"). 


ENGPA (meaning "Engineering Project A") has three 
subdirectories: WP (Word Processing), REQ 
(Requirements), and DESIGN (Design). 


You use the MD (make directory) and CD (change directory) 
commands to create the subdirectories. 


© You start MS-DOS after the fixed disk is partitioned and 
formatted, and the COMMAND.COM and external files 
have been copied to the disk. 
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* You create the three subdirectories by using the MD 
command at the C> prompt in the root directory. You 
type: 


C> md bin 


C> md intapp 


C> md engpa 


pressing RETURN after each. 
When you type: 
dir 


and press RETURN in the root directory, the screen displays: 


| volume in drive C has no label 
Directory of c:\ 


COMMAND COM 5957 6-01-86 9:00a 


BIN <DIR> 7-01-86 8:30a 
INTAPP <DIR> 7-01-86 6:15p 
ENGPA <DIR> 7-01-86 9:45a 
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All of the MS-DOS functions are available from the files in the 
BIN directory and the COMMAND.COM file in the root 
directory. 

You create the various levels of subdirectories under SALES by 


first using the CD or CHDIR (change directory) command and 
then the MD (make directory) command. For example: 


C> cd intapp 
C> md sales 
C> md costs 
C> cd sales 
C> md proda 
C> md prodb 


C> md prode 


pressing RETURN after each. 


You would create the other subdirectories under ENGPA (WP, 
REQ, and DESIGN) in a similar manner. 


You create the data files in the various subdirectories by either 
copying them to each subdirectory or using an application 
program. 
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Using Subdirectories 


When you want to get to files in any of the subdirectories, you 
start your computer and type the CD command with the 
appropriate pathname. For example: 


C> cd \intapp\sales\proda 


takes you to the PRODA subdirectory where you have the three 
data files about quarterly sales for product A. These files would 
be created typically by using a spreadsheet applications program 
and might be named by the quarter (for example, 1QTR) with the 
extension SSF (meaning "spreadsheet file"). 


By placing your various files into subdirectories, you provide an 
easy way to organize and access files stored on the fixed disk. In 
this way, operation of the computer's file storage disk is speeded 


up. 
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Upgrading MS-DOS 


If you are replacing an older version of MS-DOS with the latest 
MS-DOS Version 3.2, you will need to follow the procedures in 
one of the following sections, depending on whether you have a 
fixed disk drive and whether you want to use the automatic 
INSTLDOS.EXE program to upgrade your fixed disk or perform 
the steps manually. 


Automatically Upgrading a Fixed Disk 


You can upgrade an older version of MS-DOS with the latest 
MS-DOS Version 3.2 by using the INSTLDOS.EXE program on 
your MS-DOS System Diskette, the same program (described in 
Automatically Setting Up a Fixed Disk earlier in this chapter) 
used to automatically install MS-DOS 3.2 on your fixed disk. You 
can use INSTLDOS to perform the upgrade, as long as you have a 
fixed disk on which a version of MS-DOS earlier than MS-DOS 
Version 3.2 exists, and your computer drive configuration is a 
single-diskette and fixed-disk computer. 


Note: INSTLDOS will prompt you for the name of the 
directory containing your existing MS-DOS utilities and 
proceed to replace them with MS-DOS Version 3.2 utilities 
having the same name. If you want to save the earlier 
version of one or more utilities, use the COPY command (see 
Chapter 5) to copy them to another directory or the BACKUP 
command (also see Chapter 5) to back them up before you run 
INSTLDOS. 
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To use INSTLDOS: 


1 


Insert your working copy of the MS-DOS System 
Diskette in drive A and start, or restart, MS-DOS, 
depending on whether your computer is off or on. 
Type: 


A> instldos 


and press RETURN. 


The menu shown at the top of the next page is 
displayed 
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Welcome to the AT&T Installation Procedure 
for MS-DOS 3.2. 


If your fixed disk system has never been used 
before, this procedure will put MS-DOS 3.2 on it 
If your fixed disk system has an earlier version 
of MS-DOS on it, this procedure will upgrade it 
to version 3.2. 


At any prompt, ‘Enter choice:’, the default choice 
will be displayed. Press RETURN to accept the 
default, or enter the number of your choice 


You may exit this installation procedure, whenever 
the screen is static, by holding down the CTRL key 
while pressing the BREAK key. 

Main Menu: 

1. Do not run INSTLDOS just start MS-DOS 3.2. 


2. Begin installing MS-DOS 3.2 on a 
fixed disk that has never been used before. 


3. Continue installing MS-DOS 3.2 on a 
previously unused fixed disk. 


4. Upgrade an earlier version of MS-DOS 
on your fixed disk to version 3.2. 


Enter choice: 4 
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3 Type: 


and press RETURN. 


From this point on, you will be guided by messages displayed on 
your screen. 


Manually Upgrading a Fixed Disk 


The following procedure assumes you have a fixed disk on which 
a version of MS-DOS earlier than MS-DOS Version 3.2 exists, and 
your computer drive configuration is a single-diskette and fixed- 
disk computer. This procedure involves manual steps and is an 
alternative to the automatic upgrading procedure described in the 
previous section. 


1 Insert the MS-DOS Version 3.2 System Diskette in 
drive A. 


You will start or reboot your computer from this 
diskette. 


2 Turn on the computer, or if the computer is already on, 
press the RESET button to restart it. 


3 Enter the date and time at their prompts. 


The A> prompt appears. 
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for system on destination | a copy of MS-DOS smaller 
disk appears on the screen than MS-DOS Version 3.2.) 


4 Type: 
sys c: 
and press RETURN. 
The MS-DOS Version 3.2 hidden system files 
IBMBIO.COM and IBMDOS.COM are transferred to the 
fixed disk. Hidden files cannot be affected by most 
other MS-DOS commands. 
5 Use the table below to decide what to do next: 
If: Then: 
The error message Go to Step 6. 
Incompatible system 
size OF No room (The fixed disk contains 


The A> prompt Go to Step 26. 
appears 
on the screen 


Be sure you have enough formatted, blank diskettes 
labeled Archive01, Archive02, etc., on which to back up 
the files from drive C. (See the BACKUP command in 
Chapter 5.) 
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7 Remove the MS-DOS Version 3.2 System Diskette from 
drive A, insert the MS-DOS Supplemental Programs 
Diskette in drive A, and at the A> prompt, type: 


backup c: a: /s 


and press RETURN. 


The following message is displayed: 


Insert Archive Diskette 01 In Drive A: 
WARNING: All Files Will Be Deleted! 
Press Any Key To Continue, Control-C To abort 


8 Remove the MS-DOS Supplemental Programs Diskette 
from drive A, insert the first formatted, blank diskette 
in drive A, and press any key. 


The BACKUP command lists the date, time, size (in 
bytes), and name of each file on your fixed disk as it is 
backed up to the diskette. When the diskette is full, 
the following message is displayed: 


Insert Archive Diskette 02 In Drive A: 
WARNING: All Files Will Be Deleted! 
Press Any Key To Continue, Control-C To Abort 


9 Remove the last backup diskette from drive A, insert 
the next formatted, blank diskette in drive A, and press 
any key. 
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11 


12 


Again, the BACKUP command lists the date, time, size, 
and name of each file as it is backed up to the diskette. 
When the diskette is full, the following message is 
displayed: 


Insert Archive Diskette 03 In Drive A: 
WARNING: All Files Will Be Deleted! 
Press Any Key To Continue, Control-C To Abort 


Repeat Step 9 as many times as necessary until the MS- 
DOS A> prompt is displayed. 


Remove the last back-up diskette from drive A, insert 


the MS-DOS Version 3.2 System Diskette in drive A, 
and type: 


format c: /s 
and press RETURN. 
The following message is displayed: 


Enter current Volume Label for drive C: 


Type the volume label for drive C (if it exists) and 
press RETURN. The following message is displayed: 


WARNING, ALL DATA ON NON-REMOVABLE DISK 
DRIVE C: WILL BE LOST! Proceed with Format 


(¥7N)? 
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Type: 


and press RETURN. 


Running totals of the number of drive heads and 
cylinders appear until the entire drive C is formatted, 
at which time a message similar to the one below is 
displayed: 


Format complete 
System transferred 


21309440 bytes total disk space 
71680 bytes used by system 
21237760 bytes available on disk 


The MS-DOS A> prompt appears. 
Type: 
chmod c:\command.com +r 


and press RETURN. 


This command changes the file attributes of the 
existing MS-DOS system files so they are no longer 
read-only, hidden system files. 


Starting MS-DOS 


The following message is displayed: 
e:\ command.com A.R. 


and the MS-DOS A> prompt appears. 


15 Remove the MS-DOS Version 3.2 System Diskette from 
drive A, insert the MS-DOS Supplemental Programs 
Diskette in drive A, and type: 


restore a: c: /s/p 


and press RETURN. 


The following message is displayed: 
Are you RESTORING the Root Directory?(¥/N) 
16 = Type: 
y 


and press RETURN. 


The following message is displayed: 


Have you REBOOTED your system?(¥/N) 
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Type: 
y 


and press RETURN. 


The following message is displayed: 


Insert Archive Diskette 01 In Drive A: 
Press Any Key To Continue, Control-C To Abort 


Remove the MS-DOS Supplemental Programs Diskette 
from drive A, insert the first back-up diskette in drive 
A, and press any key. 


The following message is displayed: 


teee Files Were Archived On mm/dd/yyyy ss«* 


mm-dd-yy hh:imm nnnnnn A:\IBMBIO.COM 
The Destination File is READ ONLY or has 
been MODIFIED, Overwrite [¥/N]? 


where mm-dd-yy is month-day-year, hh:mm is hours 
and minutes, and nnnnnn is the size of the file in 
bytes. The time shown is the time the file was created. 
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Type: 


and press RETURN. 


The following message is displayed: 


mm-dd-yy hhimm nnnnnn A:\IBMDOS.COM 
The Destination File is READ_ONLY or has 
been MODIFIED, Overwrite [Y/N]? 


where mm-dd-yy, hh:mm, and nnnnnn have the same 
meanings as described in Step 18. 


Type: 


and press RETURN. 


The following message is displayed: 


mm-dd-yy hh:mm nannnn A:\COMMAND.COM 
The Destination File is READ_ONLY or has 
been MODIFIED, Overwrite [Y/N]? 


where mm-dd-yy, hh:mm, and nnnnnn have the same 
meanings described in Step 18. 
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n 
and press RETURN. 


The RESTORE command lists the date, time, size (in 
bytes), and name of each file on your fixed disk as it is 
restored from the diskette. When all the files on the 
diskette have been restored, the following message is 
displayed: 


Insert Archive Diskette 02 In Drive A: 
Press Any Key To Continue, Control-C To Abort 


22 Remove the last back-up diskette from drive A, insert 
the next back-up diskette in drive A, and press any key. 
The following message is displayed: 


Insert Archive Diskette 03 In Drive A: 
Press Any Key To Continue, Control-C To Abort 


23 Repeat Step 22 as many times as necessary until the 
MS-DOS A> prompt is displayed. 


24 Remove the last back-up diskette from drive A, insert 
the MS-DOS Version 3.2 System Diskette in drive A, 


and type: 
chmod c:\command.com -r 


and press RETURN. 
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The following message is displayed: 
c3N\ command.com A.R. 


and the MS-DOS A> prompt appears. 
Type: 

replace a:\*.* c: \pathname /r 
where pathname is the name of your subdirectory 
containing your existing MS-DOS utilities (assuming 
they do not reside in the root directory), and press 
RETURN. 
This replaces the existing MS-DOS COMMAND.COM 
and external commands in the specified path on the 
fixed disk with MS-DOS Version 3.2 files of the same 
names on the MS-DOS System Diskette. 


When the REPLACE command is complete, the A> 
prompt appears. 


Type: 


replace a:\*.* c:\pathname /a 
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where pathname is the name of the subdirectory 
containing your existing MS-DOS utilities (assuming 
they do not reside in the root directory), and press 
RETURN. 


This REPLACE command adds new utilities in MS-DOS 
Version 3.2 from the MS-DOS System Diskette to the 
specified directory on the fixed disk 


When the REPLACE command is complete, the A> 
prompt appears. 


Type: 
replace b:\*.* c:\ pathname /r 


where pathname is the name of your subdirectory 
containing your existing MS-DOS utilities (assuming 
they do not reside in the root directory), and press 
RETURN. 


The following message is displayed: 


Insert diskette for drive B: 
Strike any key when ready ... 


Remove the MS-DOS System Diskette Version 3.2 from 
drive A, insert the MS-DOS Supplemental Programs 
Diskette in drive A, and press any key 
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This REPLACE command replaces the existing MS-DOS 
files in the specified path on the fixed disk with 
MS-DOS Version 3.2 files by the same names on the 
MS-DOS Supplemental Programs Diskette. 


When the REPLACE command is complete, the 
following message is displayed: 


Insert diskette for drive A: 
Strike any key when ready ... 


29 Remove the MS-DOS Supplemental Programs Diskette 
from drive A, insert the MS-DOS Version 3.2 System 
Diskette in drive A, and press any key. 


The A> prompt appears. 


30 Type: 
replace b:\*.* c:\pathname /a 


where pathname is the name of the subdirectory 
containing your existing MS-DOS utilities (assuming 
they do not reside in the root directory), and press 
RETURN. 


The following message appears: 


Insert diskette for drive B: 
Strike any key when ready... 
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Remove the MS-DOS Version 3.2 System Diskette from 
drive A, insert the MS-DOS Supplemental Programs 
Diskette in drive A, and press any key. 


This REPLACE command adds new files in MS-DOS 
Version 3.2 from the MS-DOS Supplemental Programs 
Diskette to the specified directory on your fixed disk. 


When the REPLACE command is complete, the 
following message is displayed: 


Insert diskette for drive A: 
Strike any key when ready... 


Remove the MS-DOS Supplemental Programs Diskette 
from drive A, insert the MS-DOS Version 3.2 System 
Diskette in drive A, and strike any key. 


The A> prompt appears. 


This completes the procedure for upgrading MS-DOS on your 
fixed disk. To start using MS-DOS 3.2, reboot the system from 


drive C. 
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Introduction 


-—————— 


In this chapter, you will learn: 


How AT&T's on-screen Help facility can help you learn 
about MS-DOS commands, batch processing commands, 
and other MS-DOS topics. 


How to accomplish the most commonly needed MS-DOS 
tasks with nine common commands, whether your system 
has a single diskette drive, two diskette drives, or a 
diskette drive and a fixed disk. 


How to customize your system with the CONFIG.SYS file, 
which MS-DOS reads automatically at start-up time. 


How to execute MS-DOS commands automatically at start- 
up time with the AUTOEXEC.BAT file. 


Other helpful hints for using MS-DOS. 
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Getting Help 


With this release of MS-DOS, AT&T is providing a new Help 
facility. This Help facility describes, explains, and shows 
common usage for many of the MS-DOS commands and related 
subjects. 


The Help facility is provided on a separate disk. Once you install 
it, help is available by typing the HELP command. This 
command enables you to list an index (table of contents) of 
available help topics and to choose a topic from the index. 
Alternatively, you can type help and a topic name to bypass the 
index and display help information on the specified topic. 


Help information is displayed in a two-level format. The first 
screen of help information on a topic is a brief definition of the 
command that you can use as a "quick reference." The second and 
subsequent screens on a help topic are much more detailed. This 
level of help provides an in-depth definition, syntax, options 
definitions, examples, and, if necessary, references to other 
pertinent information. 


In addition, you can customize the MS-DOS Help facility to suit 
your needs better. This means you can: 


© Change the standard, AT&T-provided set of help topics. 


© Add other sets of help topics (perhaps for an application 
you have installed on your system). 


© Maintain help information for all topics using the text 
editor or word processor of your choice to create and 
change help files, and MS-DOS commands such as REN 
and DEL to rename and delete files. 


Refer to Chapter 7, Getting Help, for installation instructions and 
complete details of the MS-DOS Help facility. 
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MS-DOS Commands for Common Tasks 


Most of the remaining sections in this chapter will tell you how 
to accomplish the most commonly needed MS-DOS tasks with 
nine commands, whether your system has a single diskette drive, 
two diskette drives, or a diskette drive and a fixed disk. Where 
steps in the instructions differ, they will be marked as follows: 


¢ WITH ONE DRIVE — Follow only if your system has a 
single diskette drive. 


* WITH TWO DRIVES — Follow only if your system has 
two diskette drives. 


¢ WITH FIXED DISK — Follow only if your system has a 
diskette drive and a fixed disk. 


Some steps apply to two types of systems and are marked for 
both, for example, WITH ONE DRIVE/TWO DRIVES. 


If a step is unmarked, you should follow it regardless of the 
system you have. 


Before You Start 


Before you use any of the commands described in this chapter, 
MS-DOS must already be started up, or "loaded," into memory, 
and you should see the MS-DOS prompt (usually A> or C>) on 
the screen. This prompt will return to your screen when the 
command has finished performing its task. 


WITH ONE DRIVE/TWO DRIVES: Keep a working copy of the 
MS-DOS System Diskette available. Before using an MS-DOS 
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external command (defined below), make sure drive A is the 
default drive by typing after the MS-DOS prompt: 


and pressing RETURN. 


Then insert the working copy of the MS-DOS System Diskette 
into drive A. 


WITH FIXED DISK: Make sure the files on the MS-DOS System 
Diskette have been copied to your fixed disk and that your PATH 
system variable includes the subdirectory that contains those files. 
(If you've set up your fixed disk with the INSTLDOS program 
described in the Automatically Setting Up a Fixed Disk section 
of Chapter 3, this has already been done.) 


WITH ONE DRIVE/FIXED DISK: Some MS-DOS commands will 
ask you to switch diskettes in your drive. Never remove or 
replace a diskette in the drive until you are told to do so. 


Common Internal and External Commands 


In the process of starting MS-DOS, some commands are loaded 
into memory where they are available as long as your computer 
displays the MS-DOS prompt. These are called internal commands. 
They are loaded when your computer reads the 
COMMAND.COM file. You don’t need a copy of the MS-DOS 
System Diskette in a drive in order to use one of them. The 
common internal commands and their functions are given in the 
table at the top of the next page. 
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Command | Function 

DIR Finding out what files are 
in a directory 

COPY Copying a file 

TYPE Looking at a file’s contents 

REN Changing a file’s name 

DEL Removing a file 


Other MS-DOS commands require that you have a copy of the 


MS-DOS System Diskette or the MS-DOS Supplemental Programs 
Diskette in a drive or in a subdirectory of a fixed disk. These are 


called external commands. They are not automatically loaded into 
memory when you start MS-DOS. The most common external 
commands and their functions are given in the table below. 


Command Function 

FORMAT Preparing a diskette or 
fixed disk for use 

DISKCOPY | Copying a diskette 

DISKCOMP | Comparing diskettes 

COMP Comparing files 
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If you want to operate on a given file (using the COPY, DIR, 
TYPE, REN, DEL, or COMP commands, for example), the file must 
be on the fixed disk or on a diskette in one of the drives. If the 
file is not in the current drive or directory, you must specify the 
proper drive or pathname (or both) so that MS-DOS can find the 
file. 


The procedures in this chapter show you how these commands 
are typically used. For a more complete explanation, see 
Chapter 5, MS-DOS Commands. 
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Formatting a Disk 
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FORMAT is an external command that prepares a diskette or fixed 
disk to receive information. You only need to format a disk once, 
when it is new. FORMAT sets up the tracks and sectors where 
data is written on the disk by your computer. FORMAT also 
checks the disk to make sure it has no flaws, then creates the root 
directory for the files you eventually write on the disk. 


Warning: FORMAT irreversibly removes all of the 
information on a diskette or fixed disk. Be sure the disk you 


are going to format does not contain information you want to 
keep. Never format a fixed disk unless absolutely necessary. 


To Format a Diskette 


1 WITH ONE DRIVE/TWO DRIVES: Insert the MS-DOS 
System Diskette into drive A. 


2 Type: 
format b: 
and press RETURN. 
This message appears on the screen: 


Insert new diskette for drive B: 
and strike ENTER when ready 


3° WITH ONE DRIVE: When the drive A light goes off, 
remove the MS-DOS System Diskette from drive A, 
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insert the new diskette you want to format into drive A, 
and press RETURN. 


WITH TWO DRIVES: Insert the diskette you want to 
format into drive B and press RETURN. 


WITH FIXED DISK: Insert the diskette you want to 
format into drive A and press RETURN. 


While the diskette is being formatted, this message 
appears: 


Formatting ... 


After the procedure is finished, you see a message like 
the one below: 


Formatting ... Format complete 


362496 bytes total disk space 
362496 bytes available on disk 


Format another (Y/N)? 


Note: The message on your screen may also show 
some number of bytes in "bad" or unusable sectors. 
If the screen message shows bad sectors, try 
formatting again. Discard the diskette if there are 
still more than 3,000 bytes in bad sectors. 


4-10 


Using MS-DOS Commands 


5 If you have more diskettes to format, type: 


y. 


and press RETURN. Then repeat steps 3 and 4. 


To stop formatting, type: 


and press RETURN. 


The MS-DOS prompt appears, and you can remove the 
newly formatted diskette from the drive. 


To Format a Fixed Disk 


Warning: Formatting a partition of a fixed disk destroys all 
data within that partition. Never format a fixed disk unless 
absolutely necessary. 


If you absolutely must format your fixed disk, first run the 
BACKUP program (described in Chapter 5) to ensure that your 
data is safe before formatting the fixed disk. 


You only have to format a fixed disk partition once—when it is 
new. Formatting a disk partition is part of the INSTLDOS 
procedure, described in the Automatically Setting up a Fixed 
Disk section of Chapter 3. 
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System Files 


THE FORMAT command can be used to create a bootable diskette 
or to transfer MS-DOS to the MS-DOS partition of a fixed disk. If 
you include /S after the FORMAT command, MS-DOS copies the 
system files to the target disk after formatting the disk. There are 
three system files: IBMBIO.COM and IBMDOS.COM, which are 
“hidden" and are usually not affected by other MS-DOS 
commands, and COMMAND.COM. 


This type of FORMAT command is entered as: 
format b: /s 


Note: Formatting a DOS data partition on a fixed disk using 
the /S option does not enable you to start MS-DOS from the 
DOS data partition. 


The formatted diskette can be used instead of the MS-DOS 
System Diskette to start MS-DOS directly. If you add system files 
to a formatted diskette, a typical screen shows: 


362496 bytes total disk space 
43008 bytes used by system 
319488 bytes available on disk 
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Drives and Options 


This drive: | Can format If you type 
these diskettes: these options 
after 
FORMAT: 
360-Kb 160-Kb, single-sided 1118 


180-Kb, single-sided 11 
320-Kb, double-sided 18 
360-Kb, double-sided none 


1.44-Mb 720-Kb, double-sided none’) 
1.44-Mb, double-sided | none / 


1.2-Mb 160-Kb, single-sided /1/4/8 
180-Kb, single-sided /1/4 
320-Kb, double-sided /4/8 
360-Kb, double-sided 14 
1.2-Mb, high-capacity | none 


Note: If you format a lower-capacity diskette in a 1.2-Mb, 
high-capacity drive, you may not be able to read the diskette 
in a 360-Kb drive. 
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Locating Files on a Disk 
es 


DIR is an internal command that displays the names and file 
statistics of the files in a disk directory. When you are looking for 
specific files and you don’t know their locations or exact names, 
the DIR command can help you find them. 


To Display Filenames 


1 Change the current drive and directory to the ones you 
want to list (if necessary). 


2 Type: 
dir 


and press RETURN. 
3 The following is displayed on the screen: 


e The volume label of the disk (if it has one) 
e The name of the directory that is being listed 


¢ The directory’s files—one line is displayed for each 
file with this information: 


— Filename 
— Extension 
— Size (in bytes) 


— Date and time that information was last 
written in the file. 


e The subdirectories under the current directory with 
the dates and times of their creation 
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Sv 


* The total number of files and subdirectories listed 


* The amount of free space left on the disk (in bytes). 


A typical listing looks like this: 


Volume in 
Directory 


ASSIGN 
ANSI 
AUTOEXEC 
BASIC 
BASICA 
COMMAND 
CHMOD 
coMP 
CHKDSK 
DISKCOMP 
DISKCOPY 
EDLIN 
FORMAT 
BIN 

LIB 

TMP 


When all the files have been displayed, the MS-DOS prompt 


returns. 


Note: If the screen is scrolling too fast for you to read the 


drive C has no label 


of C: 

<DIR> 

<DIR> 
com 864 
sys 2510 
BAT 3 
com 686 
com 686 
com 23210 
com 6704 
com 2845 
com 9435 
com 4074 
com 4665 
com 7261 
com 9390 

<DIR> 

<DIR> 

<DIR> 


7-06-86 
7-06-86 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
8-09-85 
9-06-86 
9-06-86 
9-06-86 


6p 
6p 
Op 
12:00P 
op 
:00p 
Oop 
:00p 
Op 
op 
Op 
oop 
12:00p 
12:00p 
12:00p 
12:00p 
12:00p 
12:00p 


18 File(s) 2045952 bytes free 


files, stop it by pressing CTRL-S. To resume scrolling, press 


any key. 
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If you type: 
dir /p 


and press RETURN, the directory display halts as soon as the 
screen is full (/P means Page). Press any key to resume the 
listing. 


If you type: 
dir /w 


and press RETURN, only the filenames and subdirectory names 
are displayed, five to a line across the screen (/W means Wide). 
This lets you look at a large directory at a glance. 
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Copying a Diskette 


Always make duplicates of your important diskettes. 


This is a rule that every computer user learns the hard way. To 
avoid having to repeat hours of work or replace vital programs, 
make copies of your files and put them away in a safe place. 


As you learned in Chapter 1, it’s a good idea to make working 
copies of your program diskettes as soon as you get them. Use 
the copies for daily work and store the originals in a safe place. 
The DISKCOPY command makes a duplicate of an entire diskette 
on another diskette. 


Note: The date and time shown with a directory entry are 
the date and time of the last addition or change to that file. 
The date and time are not changed when you use the 
DISKCOPY command. 


DISKCOPY does not copy certain "copy-protected" diskettes. 


To Duplicate a Diskette 
Notes: 


The diskette you're duplicating (source) and the diskette 
you're copying to (target) must be of the same type or 
DISKCOPY will display an error message. 


If the target diskette you use has files on it, all of these old 
files are erased when you use DISKCOPY. That’s because 
DISKCOPY makes an exact duplicate of the source diskette 
onto the target diskette. It copies the diskette, sector by 
sector, regardless of what information is contained in each 
sector. 
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DISKCOPY will also format the target diskette if it has not 
already been formatted. 


1 


WITH ONE DRIVE/TWO DRIVES: Insert the MS-DOS 
System Diskette into drive A. 


Type: 
diskcopy a: b: 


and press RETURN. 


WITH ONE DRIVE: This message appears: 


Insert source diskette in drive A: 
Strike any key when ready 


Remove the MS-DOS System Diskette that is in drive A. 
Insert your source diskette into drive A and press any 
key. 


WITH TWO DRIVES: This message appears: 


Insert source diskette in drive A: 
Insert target diskette in drive B: 
Strike any key when ready 


Remove the MS-DOS System Diskette, insert the source 
diskette into drive A and the target diskette into drive B. 
Press any key when ready. If the target diskette is not 
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formatted, or is formatted differently from the source 
diskette, DISKCOPY will display: 


Formatting while copying 
WITH FIXED DISK: This message appears: 


Insert source diskette in drive A: 
Strike any key when ready 


Insert your source diskette into drive A and press any 
key. 


WITH TWO DRIVES: The lights on drives A and B go 
on and off as the copying proceeds. Do not open either 
drive door at any time during the process. DISKCOPY 
is complete when the following appears: 


Copying complete 
Copy another (¥/N)? 
Remove the target diskette, prepare an appropriate label, 


apply the label to the diskette, and store it in its paper 
sleeve. 


WITH ONE DRIVE/FIXED DISK: The light on drive A 
comes on while the source diskette is being read. 
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When the computer has read the entire source diskette 
(or as much of it as can fit in memory), this is displayed: 


Insert target diskette in drive A: 
Strike any key when ready 


Remove the source diskette, insert the target diskette, 
and press any key. The light is on while the copy is 
being written. Depending on the amount of memory in 
your computer, you may be required to exchange 
diskettes several times until you see: 

Copying complete 

Copy another (¥/N)? 
Remove the target diskette, prepare an appropriate label, 


apply the label to the diskette, and store it in its paper 
sleeve. 


If you have more diskettes to copy, type: 


y 


and repeat steps 3 and 4. You do not have to press 
RETURN. 


If you are finished, type: 
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Comparing Diskettes 
a 


DISKCOMP is an external command that makes sure that the 
duplicate diskette you’ve just made was copied accurately. In 
most cases, the DISKCOPY command discovers any problems 
while it is performing the copy, but sometimes there is no 
warning that something has not worked out just right. 


The DISKCOMP command compares the source and duplicate 
diskettes to make sure they are identical. It’s a good idea, 
particularly with important data files or valuable programs, to 
double check by using the DISKCOMP command. 


Note: The source and duplicate diskettes must be of the same 
type or DISKCOMP will display an error message. 


For this procedure, the source diskette is the first diskette, and the 
duplicate diskette is the second diskette. 


To Compare Two Diskettes 


1 WITH ONE DRIVE/TWO DRIVES: Insert the MS-DOS 
System Diskette into drive A. 


2 Type: 
diskcomp a: b: 


and press RETURN. 
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3. WITH ONE DRIVE: This message appears: 


Insert first diskette in drive A: 
Strike any key when ready 


Remove the MS-DOS System Diskette from drive A, 
insert the source diskette into drive A, and press any 


key. 


WITH TWO DRIVES: This message appears: 


Insert first diskette in drive A: 
Insert second diskette in drive B: 
Strike any key when ready 


Insert the source diskette into drive A, the duplicate 
diskette into drive B, and press any key. 


WITH FIXED DISK: This message appears: 


Insert first diskette in drive A: 
strike any key when ready 


Insert the source diskette into drive A, and press any 
key. 


4 WITH TWO DRIVES: The drive lights go on and off as 
the computer compares the two diskettes. Do not open 
the drive doors during this process. When the process is 
complete, the screen looks like the one shown at the top 
of the next page. 
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So eeesesSSSSSSSSssFs 


A>diskcomp a: b: 

Insert first diskette in drive A: 
Insert second diskette in drive B: 
Strike any key when ready 

Comparing 9 sectors per track, 2 sides 


Diskettes comparing ok 


Compare more diskettes (Y/N)? 


WITH ONE DRIVE/FIXED DISK: The drive light comes 
on while the source diskette is being read, and then this 
message is displayed: 


Insert second diskette in drive A: 
Strike any key when ready 


Remove the source diskette from drive A, insert the 
duplicate diskette into drive A, and press any key. The 
light comes on once again while the duplicate diskette is 
being compared. 


Depending on the amount of memory in your computer, 
you may have to switch the diskettes several times until 
this message appears: 


Diskettes compare ok 


Compare more diskettes (¥/N)? 
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If you have more diskettes to compare, type: 


y 


and repeat steps 3 and 4. 


If you don’t want to compare any more diskettes, type: 


You don’t have to press RETURN. After the MS-DOS 
prompt appears you can remove the diskette(s) from the 
drive(s). 


If the diskettes are not identical, go through the copying 
and comparing procedures again. If the duplicate 
diskette does not compare successfully after you copy 
and compare twice, it is probably badly formatted. 
Reformat the troublesome diskette (not the original), 
then repeat the copy and compare procedures once 
again. 


If this last attempt does not solve the problem, discard 
the bad diskette and use another one. 
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Copying a File 
————— 


Use the internal COPY command when you want to copy files to 
or from a fixed disk, or when you want to copy only certain files 
from one diskette to another. You can use COPY with the wild- 
card characters ? and * to copy multiple files. 


Sometimes copying individual files to diskettes helps you keep 
track of your work. You might want to keep all of your copies of 
specific types of files on diskettes, arranged by subject. 


For example, you would copy company memos to the "Company 
Memos" diskette, travel expense records to the "T&E" diskette, etc. 
In another case, database files on a fixed disk should be copied 
onto diskettes after every update of the information in the entire 
file. The COPY command is the one to use. 


Note: The date and time shown with each directory entry are 
not changed during a COPY. 


Be careful. If files already exist in the target directory, COPY 
does not disturb these old files as long as their names aren’t the 
same as files being copied. If you do copy a new file into a 
directory that contains an old file of the same name, the old file 
will be replaced. 


If you COPY onto a diskette with other files, use the DIR 
command to make sure in advance there is enough space (in 
bytes) left to hold the new file(s). 


Note: The COPY command also lets you merge two or more 
source files into a single target file. Refer to Chapter 5, 
MS-DOS Commands, for more information about merging 
files with the COPY command. 
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Use the COPY command with two wild-card characters 

(COPY A:*.* B:) to move all the files from a well-used diskette to 
a fresh one. COPY places each file on the target diskette one 
after the other. Use the COMP or FC commands to compare files 
transferred using COPY. (See Comparing Files in this chapter 
and Chapter 5, MS-DOS Commands, for information on COMP. 
and FC.) Even though the information on both diskettes may be 
identical, DISKCOMP will not consider the diskettes to be 
identical because the information has been rearranged. 


The rest of this section gives three methods of using COPY. 
Depending on whether your source file is on a diskette or fixed 
disk, your target file is on a diskette or fixed disk, and what kind 
of system you have, choose method 1, 2, or 3: 


* Method 1 — Use when copying files from diskette to 
diskette on a one-diskette-drive system (with or without a 
fixed disk). 


* Method 2 — Use when copying files: 
— From diskette to diskette on a two-diskette-drive system 
— From a diskette to a fixed disk 
— From a fixed disk to a diskette. 


° Method 3 — Use when copying files from one directory to 
another or from one filename to another on a fixed disk. 
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 — 


To Copy Files (Method 1) 


1 Type: 


at the MS-DOS prompt so that drive A is the default 
drive. Insert the source diskette into drive A. Then 
change to the directory containing your source file, if 
needed. 


2 Type: 
copy filename b:\newpath\newname 


and press RETURN. 


(Substitute the name of your source file for filename, the 
drive letter of the disk you want to copy the source file 
to for b, the name of the target directory for newpath, 
and the name you want to give your target file for 
newname. If you do not want to change the filename, 
omit the target filename. In addition, make sure you 
leave spaces where indicated in the command line.) 


This message appears: 


Insert diskette for drive B: 
and strike any key when ready 
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Remove the source diskette from the drive, insert a 
formatted target diskette, and press any key. 


Depending on the size of your computer's memory, you 
may have to switch the diskettes several times to 
complete the procedure. 


When the copy has been made, the following message 
appears: 


1 File(s) copied 


A> 


To Copy Files (Method 2) 


WITH SOURCE FILE ON DISKETTE: Type: 


at the MS-DOS prompt so that drive A is the default 
drive. Insert the source diskette into drive A. Change 
to the directory containing your source file, if needed. 


WITH SOURCE FILE ON FIXED DISK: At the prompt, 
type the drive letter for your fixed disk followed by a 
colon, and press RETURN. Then change to the directory 
containing your source file. 
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2 WHEN WRITING TARGET FILE TO DISKETTE: Insert 
the target diskette into an unoccupied drive. 


WHEN WRITING TARGET FILE TO FIXED DISK: Go to 
Step 3. 


} Type: 
copy filename b:\newpath\newname 


and press RETURN. 


(Substitute the name of your source file for filename, the 
drive letter of the disk you want to copy the source file 
to for b, the name of the target directory for newpath, 
and the name you want to give your target file for 
newname. If you do not want to change the filename, 
omit the target filename. In addition, make sure you 
leave spaces where indicated in the command line.) 


When the copy has been made, the following message 
appears: 


1 file(s) copied 
To Copy Files (Method 3) 


1 At the prompt, type the drive letter for your fixed disk 
followed by a colon, and press RETURN. Then change 
to the directory containing your source file. 
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Type: 
copy filename b:\newpath\newname 


and press RETURN. 


(Substitute the name of your source file for filename, the 
drive letter of the disk you want to copy the source file 
to for b, the name of the target directory for newpath, 
and the name you want to give your target file for 
newname. If you do not want to change the filename, 
omit the target filename. In addition, make sure you 
leave spaces where indicated in the command line.) 


When the copy has been made, the following message 
appears: 


1 file(s) copied 
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Comparing Files 


COMP is an external command that lets you know whether the 
file or group of files you just copied using the COPY command is 
identical to the source file(s). 


Note: COMP cannot be used to check files you have stored 
on the diskette using the BACKUP command (described in 
Chapter 5, MS-DOS Commands). 


It is a good idea to make sure that your archival copy of a file is 
the same as the original, particularly if the information in that 
file is important. Sometimes the diskette that you are copying 
files onto may have, or may have developed, a flaw since the last 
time you used it. The COMP command checks to make sure your 
COPY command was successful. 


COMP differs from DISKCOMP in that COMP works on 
individual files rather than complete diskettes. COMP is faster 
than DISKCOMP. You can use wild-card characters to compare 


sets of files. Refer to Chapter 5, MS-DOS Commands, for more 
information about comparing multiple files. 


To Compare Files 


1 WITH ONE DRIVE/TWO DRIVES: Insert the MS-DOS 
System Diskette into drive A. 


2 Type: 
comp 


and press RETURN. 


Using MS-DOS Commands 


3° When this message appears: 
Enter primary file name 
enter the source filename: ‘ 
a:path\filename 


and press RETURN. 

(In this and subsequent commands in this procedure, 
substitute the drive letter of the disk containing your 
source file for a, the drive letter of the disk containing 
your target file for b, the name of the directory 
containing your file (if it is not in the current directory) 
for path, and the name of your file for filename.) 


4 When this message appears: 
Enter 2nd filename or drive id 
enter the name of the file you copied to the target disk: 


b:path\filename 


Note: You can omit filename if the source and 
target filenames are the same. 
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WITH ONE DRIVE: Press RETURN. This message 
appears: 


Insert diskette for drive A: 
and strike any key when ready 


If the source file is on a diskette (not the MS-DOS 
System Diskette), remove the MS-DOS System Diskette 
from drive A if it is there and insert the source diskette. 


The next message to appear is: 


Insert diskette for drive B: 
and strike any key when ready 


Remove the source diskette from drive A, insert the 
target diskette, and press any key. 


If the size of the files being compared is very large, you 
may have to switch diskettes several times. 


WITH TWO DRIVES: Insert the target diskette into drive 
B (the source should already be in drive A) and press 
RETURN. The names of the files being compared are 
displayed. 


WITH FIXED DISK: If the target file is on a diskette, 
insert the target diskette into an unoccupied drive and 
press RETURN. The names of the files being compared 
are displayed. 
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Note: If both the source and target files are on 
diskettes, follow instructions in the WITH ONE 
DRIVE: section on the previous page 


When the files have been compared and found to be 
identical, this message appears: 


Files compare ok 


Compare more files (¥/N)? 


If the files are not identical, a number of advisory 
messages appear on the screen, and the COMP program 
stops. Go through the copying and comparing steps 
again. 


If you have more files to compare, type: 


y 


and repeat steps 3 through 7. You do not have to press 
RETURN. 


If you are finished, type: 


The MS-DOS prompt is displayed. 
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Looking at a File 


—e—_—_—— 


TYPE is an internal command that lets you display the contents of 
a text file on your screen. 


You may want to do this when you are uncertain about which file 
you want to change. The TYPE command lets you quickly review 
the text of a file to check if it is the one you want. This way, you 
don’t have to start another program (for example, an editor or a 
word processor) in order to check the contents of a file. 


If you use the TYPE command with a program file, the results 
displayed on your screen may not be understandable. Because 
program files contain control characters or are in a format best 
used by a computer rather than read by a person, the contents of 
these files are often best examined by other means. 


Experimenting with program files and the TYPE command does 
not harm the program file. However, if the screen display stops 
moving and the characters at the bottom of the screen are 
unreadable or displayed in an unfamiliar format, you may need to 


push the RESET button to restart your computer and continue 
working. 


To Look at a File 


1 If the file you want to examine is on a diskette, insert 
the diskette in an unoccupied drive. 


2 Type: 
type b:\path\filename 


and press RETURN. 
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(Substitute the drive letter of the disk containing your 
file for b, the name of the directory containing your file 
for path, and the name of your file for filename.) 


The file contents are now displayed. 


Press CTRL-S to stop the scrolling. Press any key to 
resume scrolling. 


If the file is on a diskette, you can remove the diskette 
from the drive when the MS-DOS prompt reappears. 
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Changing a Filename 


REN is an internal command that lets you change a filename—its 
name, extension, or both. You can also use RENAME as a 
synonym for REN. 


You may want to change a filename to identify more easily the 
contents of a file that started out to be one thing, but ended up 
another. Other times, the REN command can be used to identify 
groups of files with common attributes. 


Renaming a file does not move it to another diskette or directory 


nor does it create a new copy. To perform either of these tasks, 
use the COPY command. 


To Change a Filename 


1 If the file you want to rename is on a diskette, insert the 
diskette in an unoccupied drive. 


2 When the MS-DOS prompt appears, type: 
rename b:path\oldfile newfile 


and press RETURN. 


(Substitute the drive letter of the disk containing your 
file for b, the name of the directory containing your file 
for path, the old filename for oldfile, and the new 
filename for newfile.) 


3 If the file is on a diskette, you can remove the diskette 
from the drive when the MS-DOS prompt reappears. 
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Removing a File From a Disk 

oe 
DEL is an internal command that removes a file from a disk. You 
can also use ERASE as a synonym for DEL. 
You could use DEL to "clean up" your disks from time to time, for 
example, to remove obsolete or duplicate files to make more room 
for new files. 

Note: Use this command with great care, especially with 

wild-card characters. Always double-check your typed entries 


before pressing RETURN. Once erased, a file cannot be 
retrieved. 


To Remove a File From a Disk 


1 If the file you want to delete is on a diskette, insert the 
diskette in an unoccupied drive. 


2 + When the MS-DOS prompt appears, type: 
del b:path\filename 


(Substitute the drive letter of the disk containing the 
file to be deleted for b, the name of the directory 
containing the file to be deleted for path, and the 
name of the file to be deleted for filename.) 


Check your typed entry. 


Press RETURN. 
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Configuring Your System 


When you start up your computer, you can tell MS-DOS to set up, 
or configure, your computer system to use its memory and to 
communicate with disk drives and other external devices in a 
standard way. For example, you can configure your system to: 


* Recognize more than five disk drives, whether they are 
real physical drives, fixed disk partitions, network drives, 
aliases for pathnames, or RAM disks. 


© Set aside part of its memory as a RAM disk. 

° Communicate with additional disk drives or other external 
devices, such as the AT&T Mouse. 

* Manipulate more than eight files at once. 


* Set aside additional areas in memory (called buffers) to 
handle reading from and writing to disk drives. 


The CONFIG.SYS file must be located in the root directory of the 
drive used to start MS-DOS. MS-DOS executes the commands in 
CONFIG.SY$S at start-up time. 


Here’s a sample CONFIG.SYS file that sets up 10 buffers and 10 
files, and allows the system to use up to seven drives, including a 
256-Kb RAM in memory: 


buffers=10 

files=10 

lastdrive=g 
device=ramdrive.sys 256 


For more information, see Appendix E, CONFIG.SYS. 
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Processing a Series of Commands 
Automatically 


MS-DOS allows you to create a file containing a series of MS-DOS 
commands that are immediately performed, one after another. 
This is called batch processing and the files used are called batch 


files. 


You could use a batch file to start other programs on a disk or to 
perform some routine start-up tasks that you usually do whenever 
you turn on your computer. If you want your computer to do 
some regular task each time you turn it on or whenever you 
restart it, you must create a file called AUTOEXEC.BAT. 


The AUTOEXEC.BAT File 


Whenever you turn your computer on or restart it, MS-DOS looks 
on the start-up drive for a file named AUTOEXEC.BAT. This file 
must be in the root directory of the start-up drive. When 
AUTOEXEC.BAT is found, MS-DOS automatically performs each 
of the commands in the file. 


An AUTOEXEC.BAT file may contain either one command ora 
long series of commands. 


AUTOEXEC.BAT has a different purpose than CONFIG.SYS: 
Although MS-DOS looks for both files and executes them (when 
found) at start-up time, CONFIG.SYS cannot contain regular 
MS-DOS commands or batch processing commands, and 
AUTOEXEC.BAT cannot contain the configuration commands 
found in CONFIG.SYS. In brief, CONFIG.SYS tells your system 
what it is (how it is set up), and AUTOEXEC.BAT tells your 
system what to do (what commands to perform) at start-up time. 
When both files are present, CONFIG.SYS is executed before 
AUTOEXEC.BAT. 
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This sample AUTOEXEC.BAT file: 


path=\bin 
prompt $p$g 
date 

time 


does the following: 


* Adds the \BIN subdirectory to your PATH system variable, 
so that when you enter commands, MS-DOS looks for 
those commands in \BIN as well as the current directory. 


* Changes the prompt to display the current directory as 
well as the current drive and a greater-than (>) symbol. 


° Lets you change the date and time. 


Note: When you use an AUTOEXEC.BAT file, MS-DOS does 
not prompt you for the date and time entries unless you 
include the DATE and TIME commands in the file. 


See Chapter 5, MS-DOS Commands, for more information about 
the PATH, PROMPT, DATE and TIME commands and Chapter 6, 


Batch Processing Commands, for more information about batch 
files. 
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Helpful Hints 


* To create a short text file at the MS-DOS prompt without 
invoking EDLIN or another editing program, at the 
MS-DOS prompt, type: 


copy con filename.txt 


where you supply the filename and extension. 


Then type your file, one line at a time. Use the 
BACKSPACE key to make any necessary corrections. 


Make sure each line is properly typed before you press 
RETURN and begin typing the following line. When you 
are finished typing the file, press CTRL-Z followed by 
RETURN to return to MS-DOS. 


Make copies of your important program and data diskettes 
regularly. Always date the label. 


Print a directory frequently and store the listing with the 
diskette. 


If a command does not work as it should: 
— Check your typing. 


— Make sure you have the correct diskette in the correct 
drive. 


— Check the directory of the diskette with the DIR 
command. 


— Make sure colons and spaces have been included where 
they should be and not where they don’t belong. 


— Make sure the filename is correctly spelled and 
includes the extension where appropriate. 
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JS 


If a command still does not work the way you expect it 
to, refer to Chapter 5, MS-DOS Commands, for more 
information about that command. 
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SHIP csessesszvevsyrceeat de tisissiavaiiied tavrend aise dyagiteses 5-146 
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Introduction 


SEE 


This chapter describes the MS-DOS commands that are not 
specifically dedicated to batch processing files. The commands are 
in alphabetical order. 
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Command Syntax 


In order for your computer to understand MS-DOS commands, 
you must enter them in an exact form, called command syntax. 
This section contains a few simple rules for interpreting the 
syntax line given with each command on the following command 
reference pages. 


° Any words in capital letters must be spelled exactly as 
shown. You can make these entries in upper-case letters, 
lower-case letters, or a mixture of both. For example, you 
can type CLS or cls or Cls to clear the screen. 


Anything enclosed in paired angle brackets (<>) is 
required information. You supply the text. For example, 
when you see <filename> on the syntax line, you type in 
the name of your file. Don’t type in the paired angle 
brackets themselves; this would cause a problem. 


Anything in square brackets (]) is optional information 
that may change the function of a command. For example, 
when you see [path] on the syntax line, you type ina 
pathname if it is different from your current path. Make 
sure you enter all the information necessary to use the 
options you want to use. Again, don’t type in the square 
brackets themselves; this would cause a problem. 


Anything in braces ({ }) indicates that you must make a 
choice among two or more entries. You must enter one 
and only one. If all choices are enclosed in surrounding 
square brackets, you do not have to enter any of them. 
For example, the syntax line BREAK [{ON} {OFF} ] 
indicates that you can type break, break on, or break off. 
Again, don’t type in the braces themselves; this would 
cause a problem. 
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* An ellipsis (...) indicates that you may repeat the previous 
entry as many times as needed. For example, the syntax 
line COPY <filename> + <filename>... <filename> 


indicates that you can type copy followed by a valid 
filename, then any number of plus signs each followed by 
valid filenames, followed by a space and a valid filename. 


* Spaces are important. You should include a single space 
in the command line: 


— After the command name 
— After each specified filename 
— After device names or other required text strings 
— Between filenames and options. 
* However, you should not include spaces: 
— Within filenames or pathnames 


— Between drive letters, pathnames, and filenames. 
Complete file specifications should omit spaces. For 
instance: 


b:\wp\alice\myplans.ltr 


should contain no space. 


¢ The syntax lines for some commands enclose brackets in 
other brackets. For example, the syntax line 
RECOVER < (filename) {drive:} > indicates that you can 
type recover followed by a valid filename or recover 
followed by a drive letter and a colon. The outer angle 
brackets indicate that you must choose one or the other. 
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For another example, [[path] <filename>] indicates that 
you have the option of typing a filename without a path, 
but you cannot type a path without a filename. 


When you see other punctuation marks (commas, equal 
signs, question marks, colons, semicolons, and slashes), 
enter them exactly as shown. These punctuation marks are 
essential. 


The syntax for some commands in this chapter is shown 
on more than one line. When you enter these commands, 
type a space instead of pressing RETURN at the point 
where the syntax continues to a new line on the command 
page. If there is not enough room on the display screen 
for your command to fit on one line, just keep typing. 
Your command will automatically continue on a new line. 
Press RETURN only when you are finished typing. 
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Directing the Results of Commands 
ee eee 


Three MS-DOS commands (FIND, MORE, and SORT) can accept 
and process the results from other MS-DOS commands on the 
same command line. 


These three commands are called filters. A vertical bar (called a 
pipe) is placed between the first complete command on the line 
and the filter. For example, the command: 


type longfile.txt| more 


displays the file LONGFILE.TXT one screen at a time. 


MS-DOS normally assumes that command input comes from your 
keyboard (called standard input) and output goes to the display 
screen (called standard output). You can also redirect command 
output into a file with the > redirection symbol. For example, 
the command: 


dir| sort > direc.fil 


sends a directory listing from the DIR command to the SORT 
command and then places the sorted output into a file named 
DIREC.FIL. 


Note: If the file DIREC.FIL is not already on the disk, 
MS-DOS creates it. If it already exists, MS-DOS writes over 
its current contents. 
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You can append command output to the end of a text file with 
two >> symbols. For example, to append the output of the DIR 
command to the end of the current DIREC-FIL file, type: 


dir >> direc.fil 


If DIREC.FIL doesn’t already exist, MS-DOS creates it. 


You can also redirect input from a file into a command with the 
< redirection symbol. For example, the command: 


sort < unsort.txt > sort.txt 


reads the file UNSORT.TXT, sorts it, and writes the sorted output 
to a file named SORT.TXT. 


Note: The > and < symbols do not have the same meaning 
as the paired angle brackets that appear on some syntax lines. 
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MS-DOS Commands 


Sanne? 


The following MS-DOS commands are described in this chapter. 


Note: Internal commands are marked with an asterisk. The 
remaining commands are external; if you do not have a fixed 
disk, you must insert your MS-DOS System Diskette or 
MS-DOS Supplemental Programs Diskette, as appropriate, in 
a drive to use an external command. 


Command Function 
APPEND Sets a search path for data files 
ASSIGN Routes requests for one drive to another 
ATIRIB Allocates a portion of random access memory as a 
disk cache for the disk drive. 
BACKUP Backs up files from a fixed disk to diskettes 
*BREAK Turns CTRL-C check on and off 
*CD Same as CHDIR 
*CHDIR Changes or shows current directory 
CHKDSK Checks the directory of the current drive against 
files on the disk 
CHMOD Changes and displays file attributes; displays 
directory attributes 
*CLS Clears screen 
*COMMAND _ Starts a new MS-DOS command processor 
COMP Compares the contents of two sets of files 
*COPY Copies file(s) specified; concatenates files 
*CITY Changes the device used by MS-DOS for 
command input 
*DATE Displays or sets date 
*DEL Deletes file(s) specified 
*DIR Lists requested directory entries 


DISKCOMP — Compares the contents of two diskettes 
DISKCOPY Copies diskettes 


*ERASE Same as DEL 
EXE2BIN Converts executable files to a binary format 
EXEC Performs a specified command on tagged files 
*EXIT Exits command processor 
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FC Compares the contents of two files 
FDISK Partitions fixed disk into logical drives 
FIND Searches for a string of text 


FORMAT Formats a disk to receive MS-DOS files 
GRAPHICS _ Enables screen graphics to be printed on a 
graphics printer 


HELP Displays help information or a topic index 

JOIN Considers a disk drive as a pathname 

LABEL Creates, changes, or deletes a volume label on a 
disk 

LINK Combines object modules when creating programs 

*MD Same as MKDIR 

*MKDIR Creates a directory 

MODE Sets display, communication, and printer 
parameters 

MORE Displays output one screen at a time 

*PATH Sets a command search path 

PRINT Prints files in the background 

*PROMPT Designates command prompt 

*RD Same as RMDIR 

RECOVER Recovers files from a damaged disk 

*REN Renames files 

*RENAME Same as REN 

REPLACE Updates previous versions of files 

RESTORE Restores files saved with BACKUP to a fixed disk 

*RMDIR Removes a directory 

*SET Assigns a value to an environment variable 

SHARE Lets multiple users share files on a network 

SHIP Prepares the fixed disk for shipping 

SIZE Lists filenames and file sizes of specified files 

SORT Sorts data alphabetically, forward or backwards 

SUBST Substitutes a drive letter for a pathname 

SYS Transfers MS-DOS system files from one drive to 
another 

TAG Tags specified files for use by EXEC 

*TIME Displays and sets time 

TREE Displays directories and their contents 

*TYPE Displays the contents of file specified 


UNTAG 
*VER 
*VERIFY 
*VOL 

XCOPY 
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Untags tagged files 

Displays MS-DOS version number 
Verifies writes to disk 

Displays volume identification number 
Copies files and directories. 


MS-DOS batch commands are described in Chapter 6, Batch 
Processing Commands. 
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AC.SYS 
ee 


AC.SYS is a device driver program that lets you use a portion of 
random access memory as a disk cache for the disk drive, thereby 
allowing you to access data faster. For more information, see 
Appendix K, AC.SYS. 
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ANSLSYS 


—_—_e_———— 


ANSLSYS is a device driver that lets you use escape sequences 
(series of characters) to define functions to MS-DOS. You can 
reassign keys, change graphics functions, and affect cursor 
movement. For information about ANSI.SYS escape sequences, 
see Appendix G, ANSLSYS. 
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APPEND 


PURPOSE 


Sets a search path for data files, that is, any file with an 
extension other than .COM, -EXE, or .BAT. 


Note: To set a search path for executable files, use the 
PATH command, described later in this chapter. 


SYNTAX 
APPEND [=drive:][path][{drive:][path}...] 


where: 
drive = drive to be searched 
path = path to be searched 
and: 
[] = optional information. 


COMMENTS 


This command allows you to tell MS-DOS the order in which 
disk drives and directories should be searched for data files 
after MS-DOS searches your current directory. The default 
value is no path. 


You can type either an equals sign (=) or a space after the 
word APPEND. If you use an equals sign, do not add spaces. 
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You can specify more than one path to search by separating 
each path with a semicolon (;). For example: 


append b:letters;a:reports 


tells MS-DOS to access data files in a directory called LETTERS 
on drive B, and in a directory called REPORTS on drive A. 
MS-DOS searches the directories in the order specified. 


If you use the APPEND command with no options, MS-DOS 
displays the current data path. 


If you use the command: 
append ; 


MS-DOS sets the NUL data path. This means that MS-DOS 
searches only the current directory for data files. 


Notes: 


You can use the APPEND command across a network to 
locate remote data files. 


If you are using both the MS-DOS ASSIGN and APPEND 
commands, you must type the APPEND command before 
ASSIGN. 
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ASSIGN 


PURPOSE 


Instructs MS-DOS to read from and write to a different drive 
from the one specified in subsequent MS-DOS commands. 


Notes: 


ASSIGN works unpredictably when used with the 
following commands: BACKUP, FORMAT, JOIN, PRINT, 
RESTORE, and SUBST. Do not use these combinations of 
commands. 


DISKCOPY, DISKCOMP, and FORMAT commands ignore 
drive assignments. 


SYNTAX 
ASSIGN [drivel = drive2}.. 


where: 
drivel = the drive you specify to read or write a 
file in later MS-DOS commands 
drive2 = the drive that actually reads and writes 
files 
and: 
{] = optional information. 
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COMMENTS 


Enter only the drive letters. Do not enter the colons on the 
command line. For example, you would type: 


assign a=c b=c 
so that applications that were designed to read or write files 
only on diskettes in drives A and B can use your computer's 


fixed disk (drive C) instead. 


Entering the ASSIGN command without any drive letters 
resets the current assignments to the default values. 


Entering an ASSIGN statement cancels the previous ASSIGN 
statement, if any. For example: 


assign a=c 
assign b=c 


causes MS-DOS to route commands including drive B to 
drive C, but does not affect drive A. 
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ATTRIB 


PURPOSE 


Sets or resets the read-only attribute and/or archive bit 
attribute of a file. 


Notes: 


In an application opens a file with read and write 
permission, ATTRIB forces read-only mode to allow file 
sharing over a network. 


The BACKUP, RESTORE, and XCOPY commands use the 
archive attribute to control a selective 
Backup/Restore/Xcopy on files that have been modified. 
You can use the +A and -A options to select files that you 
want to back up with the BACKUP /M option or copy with 
the XCOPY /M option. 


SYNTAX 


ATTRIB [+ RI/-R][+A/-A] [drive:] [file-path]filename 


where: 
drive = drive where filename is to be found 
file-path = directory where filename is to be found 
filename = filename of files to be referenced. 
Wildcard characters (* and ?) can be used 
in filename. 
and: 
[] = optional information. 
OPTIONS 


The +R option sets the read-only attribute of a file. 


The -R option disables the read-only mode. 
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The +A option sets the archive attribute of a file. 
The -A clears the archive attribute of a file. 


COMMENTS 
To display the attribute of files, enter: 


ATTRIB filename 


EXAMPLE 


The command: 
ATTRIB +R MYFILE.TXT 


makes the file named MYFILE.TXT read-only. 
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BACKUP 
ee 


PURPOSE 


Backs up one or more MS-DOS files on a series of disks. The 
source is usually a hard disk, but can be a floppy disk. The 
target is usually a floppy disk, but can be a hard disk. 
However, the source and the target must be different drives. 


SYNTAX 


BACKUP <source drive: > [path] <target drive:> 
[/S] [/M] [/A] [(/D: <date>] 


where: 
source drive = the disk drive to be backed up 
path = path containing files to be backed up 
target drive = the disk drive in which the backup 
copy is to be made 


and: 
required information 
optional information 


A 
Vv 
"ou 


Note: The files on the backup diskette cannot be used 
except for restoring the data using the RESTORE 
command. 


Warning: Do not use the BACKUP command if the drive 
you are backing up has been ASSIGNed, JOINed, or 
SUBSTituted. If you do, you may not be able to restore 
the files with the RESTORE command. 
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OPTIONS 


The /S (Subdirectory) option causes files contained in the 
subdirectories to be backup, as well as those in the specified 
directory (or current directory if no directory is specified). This 
includes files at all directory levels below the specified 
directory. 


The /M (Modified) option backs up only those files in the 
specified directory that have been modified or created since the 
last backup. 


The /A (Append) option lets you add the specified files to the 
disk already inserted in the diskette drive. If /A is not 
specified, you will be prompted to insert a diskette once the 
BACKUP program is in memory. 


The /D (Date) option backs up only those files in the specified 
(or current) directory that have been created or modified since 
the specified date. Refer to the DATE command for valid date 
formats. 


COMMENTS 


Once you have entered the BACKUP command, a prompt will 
be issued asking you to insert a target diskette (unless you 
included the /A option in the command line). You must use 
MS-DOS formatted diskettes. 


Caution: Be aware that unless you have entered the /A 
option, BACKUP will erase existing files on the back-up 
diskettes. 


Once the target diskette is full, you will be prompted to 
insert another target diskette. 
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es 


Be sure to label each diskette. The order will be important 
when you restore your backup to hard disk. Label the 
diskettes "BACKUP 1," "BACKUP 2," and so on. Add 
today’s date of you want to. 


As each file is backed up its name is displayed on the 
screen. 


Notes: 


When specifying the path, if you enter only the source- 
drive specifier, then only the files in the current directory 
will be backed up. 


If you specify a path terminating in a directory name, then 
all files in that directory will be backed up. 


If the path terminates in a file name (or a group of file 
names specified using wild card characters) only the 
specified files will be backed up. 


FOR BATCH PROGRAMMERS 

The exit code is set by the BACKUP command as follows: 
Normal completion 
No files found 


Some files not backed up due to file sharing conflicts 


Command execution terminated by user 


ON HO 


Command execution terminated due to an error 
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EXAMPLES 


The command: 
backup c:*.COM A: 


will back up each file with the .COM extension in the current 
directory of the hard disk drive C to a series of diskettes in 
drive A. 


The command: 
backup c:*.* A:/s 


will backup all files on the hard disk drive C to a series of 
diskettes in drive A. 


The command: 
backup c:mydir\myfile A: /A 


will add the file myfile in the directory mydir to the backup 
diskette on drive A. 


The command: 
backup *.* A: /M 
will back up to a series of diskettes in drive A all files in the 


current directory on drive C that have been created or 
modified since the last backup. 
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The command: 
backup *.* A: /D:01-01-87 


will back up to a series of diskettes on drive A all files in the 
current directory on drive C that were created since January 1, 
1987. 
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BREAK 


PURPOSE 
Sets the CTRL-BREAK (CTRL-C) check. 


SYNTAX 


BREAK [{ON} (OFF) ] 


where: 
[] = optional information 
() = either/or. 
COMMENTS 


Depending on the program you are running, you may press 
CTRL-BREAK to stop an activity (for example, to stop sorting a 
file). Normally, BREAK is OFF; MS-DOS checks to see if 
CTRL-BREAK has been typed only when it is reading from the 
keyboard, writing to the screen, or to a printer. Setting 
BREAK to ON allows CTRL-BREAK checking to be extended to 
other functions such as disk reads and writes. Set BREAK ON 
to enable you to stop assemble or compile processes by 
pressing CTRL-BREAK. See the System Programmer's Guide for 
more information. 


To find out how BREAK is currently set, type: 
break 


and press RETURN. 
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Note: You can also turn on extended CTRL-BREAK 
checking every time you boot your system by including 
the statement: 


break on 


in your CONFIGSYS file. See Appendix E, CONFIG.SYS, 
for more information. 
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CHDIR (CHange DIRectory) 


PURPOSE 
Changes from your current directory to a different directory; 


displays current directory. 


SYNTAX 
CHDIR [drive:][path] 


where: 
drive 
path 
and: 


drive to which you want to change 
directory to which you want to change 


{J = optional information. 


SYNONYM 
cD 


COMMENTS 


Note: If you do not specify a drive, the default drive is 
assumed. 
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If your current directory is \BIN\USER\MIKE and you want to 
change your current directory to another directory (such as 
\BIN\USER\JOE\FORMS), type: 


chdir \bin\user\joe\forms 
or 


ed \bin\user\joe\forms 


and press RETURN. 
MS-DOS will put you in the new directory. 


Two shorthand notations for the CHDIR command are also 
available. For example, 


¢ If your current directory is \BIN\USER\JOE\FORMS and 
you want it to be \BIN\USER\JOE just type: 


chdir .. 


This command will put you in the directory that 
contains your current directory. It will not work if you 
are in the root directory. 


¢ If your current directory is \BIN\USER\MIKE and you 
want it to be \BIN\USER\MIKE\STUFF just type: 


chdir stuff 
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This abbreviation will put you in a directory named 
STUFF that is contained within your current directory 
(if such a directory exists). 


To return to your root directory from any directory, type: 
chdir \ 


CHDIR used without a pathname displays your current 
directory. If your current directory is \BIN\USER\JOE on 
drive B, and you type: 


chdir 
MS-DOS displays: 
b:\bin\user\joe 


Using the CHDIR command in this way is useful when you 
need to know the name of your current directory. 


Note: You can also use the PROMPT command to display 
your current directory in the MS-DOS prompt. Refer to 
the PROMPT command description later in this chapter 
for more information. 
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The command: 
chdir b: 


will display the current directory on drive B. 


You can change the current directory on another disk, but it 
does not make that disk the default disk. You must typea 
disk letter and colon at the MS-DOS prompt to change the 
default disk. For example: 


A> chdir c:\joe\today 
A> 


changes the current directory on drive C to \JOE\TODAY, but 
drive A still holds the default disk. 
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CHKDSK (CHecK DiSK) 


PURPOSE 


Scans the directory of a specified disk to check that it is 
consistent with the files on the disk. CHKDSK displays any 
errors found. 


Note: This command does not work over a network. 


SYNTAX 
CHKDSK [drive:][path][filename] [/F][/V] 


where: 
drive = drive to be checked 
path = path containing file to be checked 
filename = file to be checked 
and: 
0 


optional information. 


OPTIONS 
The /F (Fix) option tells CHKDSK to attempt to fix any errors 
found. 


The /V (Verbose) option displays the full pathname and 
filename of every file and directory as it is checked. 


COMMENTS 


CHKDSK should be run occasionally on each disk to check for 
errors. If any errors are found, CHKDSK will display error 
messages, if any, and then display a status report. 


5-31 


MS-DOS Commands 
CHKDSK 


A sample status report looks like this: 


160256 bytes total disk space 
8192 bytes in 2 hidden files 
512 bytes in 2 directories 

30720 bytes in 8 user files 

121344 bytes available on disk 


65536 bytes total memory 
53152 bytes free 


If you type a filename after CHKDSK, MS-DOS displays a 
status report for the disk and for the individual file. You can 
use wild-card characters in the filename to display reports for 
multiple files. Each report includes the number of 
noncontiguous areas that the file occupies on the disk. 


If you want to save the status report for future use, you can 


redirect the output from CHKDSK to a file with a command in 
this form: 


chkdsk drive: > filename 


The report will be sent to the filename specified. Do not use 
the /F option if you redirect CHKDSK output. 


If you see the message: 


n lost clusters found in m chains 
Convert lost chains to files (¥/N)? 


CHKDSK has found information on your disk that may be 
parts of data files that have somehow been separated from 


5-32 


MS-DOS Commands 
CHKDSK 


their original files. CHKDSK takes different actions, 
depending on whether you have run CHKDSK with the /F 
option. 


If you have specified the /F option and you type: 


¥ 


the lost clusters are written into files that are placed into the 
root directory with names in the format FILEnnnn.CHK. You 
can then attempt to repair and rename these files or delete 
them. 


If you have specified the /F option and you type: 


CHKDSK displays: 
nnnan bytes disk space freed 


and frees the disk space to create room for more files. 


If you have not specified the /F option and you type: 


CHKDSK does nothing. 
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If you have not specified the /F option and you type: 


CHKDSK displays: 


mnnn bytes disk space would be freed 


but does not free the disk space to create room for more files. 
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CHMOD (CHange MODe) 


PURPOSE 


Changes and displays file attributes; displays directory 
attributes. 


SYNTAX 


CHMOD [drive:][path][filename] 
[{+S}{(-S}][(4+R} {-R)][(+H) (- H+ A} (-A)] 


where: 
drive = drive containing file 
path = path containing file 
filename = file whose attributes are to be changed or 


displayed 
and: 
[] = optional information. 
) = either/or. 
COMMENTS 


CHMOD is used to change, modify, or list file or subdirectory 
attributes. The file attributes can be combinations of the 
following: 


S System file — the IBMBIO.COM and 
IBMDOS.COM files used by MS-DOS. 
Normally these files are hidden from MS-DOS 
users. 
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R Read-Only file — these files can only be read 
from, not written to. 
H Hidden file — a file hidden from MS-DOS 
users. 
A Archive file — a file that has not been backed 


up. Every time MS-DOS appends, modifies, or 
creates a file, this attribute is turned on. 


<dir> Directory — nota file. Another directory that 
has information about other files. 


Using this utility, you can set or clear any of the file attributes 
except the Directory attribute. Global characters are allowed 
in filenames. You must enter a space between the filename 
and the first attribute, but spaces between attributes are 
ignored. 


To set an attribute for any file, enter a (+) plus sign after the 
filename followed by the attribute letter code. 


To clear an attribute, enter a (—) minus sign followed by the 
attribute letter code to be cleared. Any letter code entered 
without a set or clear option will default to setting the 
attribute, a (+) plus sign. You can set or clear multiple 
attributes by entering more than one letter after the + or — 
signs. 
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EXAMPLES 


The command: 
chmod 


displays a short message explaining command syntax and 
options. 


The command: 
chmod a:*.* 


displays attributes for the files in the current directory on 
drive A. 


The command: 
chmod diskcopy.exe +h+r 


sets the Hidden and Read-Only attributes for the filename 
DISKCOPY.EXE. 


The command: 
chmod b:\overlays\wsmsgs.ovr —r 


clears the Read-Only attribute from the filename 


WSMSGS.OVR in the subdirectory OVERLAYS on drive B. 
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The command: 
chmod b:\regional\*.dat 


displays attributes for all filenames with the extension .DAT in 
the subdirectory REGIONAL on drive B. The output would 
look like this: 


b east.dat AR 
bi north.dat R 
b: south.dat AR 
b: west.dat R 
4 files. 
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CLS (CLear Screen) 


PURPOSE 


Clears the computer screen. The CLS command is often used 
in batch processing to clear the display before another 
command begins. 


SYNTAX 


CLS 
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COMMAND 


PURPOSE 
Starts a new command processor (the MS-DOS program that 
contains all internal commands). 


SYNTAX 
COMMAND ({drive:][path] [/E:nnnnn][{/P} (/C <string>}] 


where: 
drive = drive where COMMAND.COM is located 
path = path where COMMAND.COM is located 
string — a valid command name 


and: 
<> = required information 
[] = optional information 
Q} = either/or. 
OPTIONS 


The /E option specifies the environment size, where nnnnn is 
the size in bytes. The size may range between 160 and 32,768 
bytes. 


The environment is an area of memory set aside for several 
MS-DOS global variables: 


° COMSPEC, the drive and path where 
COMMAND.COM is stored 


© PATH, the list of directories MS-DOS searches for 
executable files (files with .COM, .EXE, or .BAT 
extensions) 
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° APPEND, the list of directories MS-DOS searches for 
data files 


* PROMPT, the MS-DOS system prompt 


¢ Any other global variables created with the SET 
command (described later in this chapter). 


The environment generally expands as needed to 
accommodate all the MS-DOS global variables. However, if 
you run a memory-resident program, expansion stops and the 
environment may run out of room. Expanding the 
environment with COMMAND reserves a fixed amount of 
room for global variables. 


If nnnnn is less than 160 or greater than 32,768 bytes, 
MS-DOS displays the message: 


Invalid environment size specified 


The /P option tells the new COMMAND.COM to become 
permanent in memory. You will not return to the original 
command processor until you type EXIT at the MS-DOS 
prompt or restart MS-DOS. COMMAND.COM does not read 
the AUTOEXEC.BAT file unless you enter the /P option. 


The /C option, if used, should be the last option in the 
command. It tells the command processor to execute string 
(the command or commands specified after /C) and then 
return to the original command processor. You should 
include a space between /C and string. 
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COMMENTS 


The command processor is loaded into memory in two parts: 
the transient part and the resident part. Some application 
Programs write over the transient part of COMMAND.COM 
when they run. When this happens, the resident part of the 
command processor looks for the COMMAND.COM file on 
disk so it can reload the transient part. 


EXAMPLES 


The command: 
command /c chkdsk b: 


tells the command processor to start a new command processor 
under the current program, run the command CHKDSK B:, 
and return to the first command processor. The 
AUTOEXEC.BAT file is not re-read. 


The command: 
command c:\bin /p /e:3000 


tells the present command processor to start a new command 
processor, set the environment to 3,000 bytes, look for 
COMMAND.COM in the \BIN directory of drive C (if 
necessary), re-read the AUTOEXEC.BAT file, and use the 
second command processor to stay resident in memory. 
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COMP (COMPare files) 


PURPOSE 


Compares each member of the first specified set of files to its 
corresponding member in the second specified set of files. 
The sets of files may be in separate directories or on separate 
disks. 


SYNTAX 
COMP [drive1:][path1][filename1][drive2:][path2][filename2] 


where: 
drivel = drive containing first file to be compared 
path1 = path containing first file to be compared 
filenamel = first file to be compared 
drive2 = drive containing second file to be 
compared 
path2 = path containing second file to be 
compared 
filename2 = second file to be compared 
and: 
[] = optional information. 


COMMENTS 


COMP will prompt for filenames if one or both file 
descriptions are missing or if no filename matches the first file 
description. 


COMP will compare single files or sets of files. If the filename 
is missing, COMP assumes a file description of *.*. If no disk 
drive is specified, COMP uses the default drive. 
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By using only directory names, it is possible to compare all the 
files in one directory with all the files with the same filename 
and/or extension in another directory. 

COMP displays the names and paths of each file it compares. 
If a specified path is invalid, the files are different sizes, or no 
file matches the second file description, COMP does not 
compare the files and displays an error message instead. 

If COMP finds a discrepancy between two files, it displays the 
relative location, or offset, of the discrepancy and the 
mismatched bytes, all in hexadecimal notation. 


After 10 mismatches, COMP stops comparing files and displays 
the message: 


10 Mismatches - ending compare 
If the files are identical, COMP displays: 
Files compare OK 


After comparing two files, COMP proceeds with the next pair 
of files matching the file descriptions until no more files 
match the first file description. Then COMP asks: 


Compare more files (¥/N)? 


To compare more files, type: 


bs 
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COMP will prompt you for two more file descriptions. 
To return to the DOS prompt, type: 


n 


During comparison, COMP may display the message: 
EOF mark not found 


This is not necessarily an error. COMP always looks at the 
last byte of the last block of the files being compared to check 
whether it is an end-of-file character (CTRL-Z, 

hexadecimal 1A). Sometimes, this character falls earlier in the 
block, if the entire block is not needed for data. In this case, 
you can safely ignore this message. 
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CONFIG.SYS 


CONFIG.SYS is a special file that is processed automatically when 
MS-DOS starts. It may contain commands that modify MS-DOS 
parameters and allow MS-DOS to use any special hardware you 
have installed in your computer. For information about 
CONFIG.SYS, see Appendix E, CONFIG.SYS. 
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COPY 


PURPOSE 


Copies one or more files from the current or specified 
directory to another disk, directory, or filename. You can also 
append one or more files to the end of an existing file or 
concatenate one or more files into a new file. 


COPYING FILES 


SYNTAX 


COPY [drive1:][path1:] <filename1> [/V][/A][/B] 
[drive2:][path2:][filename2] [/A][/B] 


where: 
drivel = drive containing file to be copied from 
path1 = path containing file to be copied from 
filenamel = name of file to be copied from 
drive2 = drive containing file to be copied to 
path2 = path containing file to be copied to 
filename2 = name of file to be copied to 
and: 
<> = required information 
[] = optional information. 


Notes: 


You must specify at least one of the arguments drive2, 
path2, or filename2. If you do not specify a drive or path, 
COPY substitutes the name of the current drive or path. If 
you do not specify filename2, COPY will copy the new 
file to filenamel on drive2 and path2. COPY will not 
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coPy 
copy a file to itself. If filename2 already exists, COPY will 
write the new file over it, erasing the current contents of 
filename2. 

Options 


The /V option causes MS-DOS to verify that sectors written on 
the target disk are recorded properly. This option is useful for 
verifying that your files have been correctly copied, but it 
causes MS-DOS to run more slowly. (This option uses the 
same method of verifying files as the VERIFY ON command, 
but /V is in effect only as long as the COPY command is 
being executed.) MS-DOS displays an error message if it 
discovers an error in copying. 


The /A option applies to ASCII, or text files. 


* When used after filename, /A causes the first file to 
be treated as a plain ASCII file, containing printable 
characters only. Data in the first file is copied up to, 
but not including, the first end-of-file character 
(CTRL-Z). The remainder of the file is not read or 
copied. 


When used after filename2, /A appends an end-of-file 
character (CTRL-Z) as the last character of that file. 
Thus, if /A is used for both filenames, COPY will 
remove and replace the same end-of-file character as it 
copies the file. The bytes following CTRL-Z in the last 
sector of each file will not necessarily be the same. 
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The /B option applies to binary, or executable files. 


* When used after filenamel, /B causes all bytes in every 
sector of the file to be read, even if one or more bytes 
are end-of-file characters (CTRL-Z). 


© When used after filename2, /B does not append an 
end-of-file character (CTRL-Z) as the last character of 
the target file. Thus, if /B is used for both filenames, 
COPY will copy every sector in the source file to the 
target file, byte for byte. 


Notes: If you do not specify the /A or /B options 
after the source file, COPY automatically chooses 

the correct option, depending on the type of data 
in the source file. 


If /A or /B is specified for the source file but not 
the target file, COPY automatically chooses the 
same option for copying to the target file. 


EXAMPLES 


If your current drive is C and your current path is /WP/ME, 
the command: 


C> copy a:tuesday.wrk today.wrk 


copies the file TUESDAY.WRK from the diskette in drive A 
into the file TODAY.WRK in the path /WP/ME (the current 
path) on the drive C: (the current drive). 
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The command: 
C> copy thursday.wrk a: 


copies the file THURSDAY.WRK in the current path on the 
current drive into the file THURSDAY.WRK on the diskette in 
drive A. 


The command: 
copy thursday.wrk 


has no effect. COPY interprets the previous line as a 
command to copy a file onto itself. 


COPYING FILES TO AND FROM DEVICES 


You can use reserved device names to copy files to and from 
devices. You can copy from these devices: 


AUX CON 
COM1 NUL 
COM2 


to these devices: 


AUX COM2 LPT3 
CON LPT1 PRN 
COM1 LPT2 NUL 
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Note: You may have to use the MODE command 
(described later in this chapter) to ensure that these 
devices are properly configured. 


This can be handy when you want to write a short file 
without invoking an editor. Just type: 


copy con myfile.txt 


and start typing lines of text. All the text you now type on 
the keyboard will be saved in MYFILE.TXT. After you type 
the last line of text, press CTRL-Z to save the text and display 
the MS-DOS prompt. 


APPENDING FILES 
SYNTAX 


COPY [drive1:][path1:] <filename1l> + 
[[drive2:][path2][filename2] + ...] 


where: 

drivel = drive containing filenamel 
path1 = path containing filenamel 

filenamel = name of existing file to which other files 

are appended 

drive2 = drive containing filename2 
path2 = path containing filename2 

filename2 = name of file to be appended to filenamel 
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and: 
<> = required information 
[] = optional information. 


Note: COPY automatically uses the /A option when 
appending files. 


EXAMPLES 


The examples in this section ard CONCATENATING FILES 
use three text files. Their filenames and contents are listed 
below. 


CITYA.TXT CITYB. TXT CITYC. TXT 
Annapolis Birmingham Chicago 
Atlanta Boston Columbus 


The command: 
copy citya.txt + cityb.txt + cityc.txt 


appends the files CITYB.TXT and CITYC.TXT, in that order, to 
CITYA.TXT. After the command, the contents of the three 
files are: 


CITYA.TXT CITYB.TXT CITYC.TXT 


Annapolis Birmingham Chicago 
Atlanta Boston Columbus 
Birmingham 

Boston 

Chicago 

Columbus 


5-52 


MS-DOS Commands 
COPY 


The command: 


copy citya.txt + city*.txt 


has exactly the same effect as the previous command. When 
you use wild-card characters to append files, COPY compares 
each source filename with the target filename. If they are the 
same, COPY does not copy that one source file, and instead 
displays the error message: 


Content of destination lost before copy 


Further appending proceeds normally. 


CONCATENATING FILES 
SYNTAX 


COPY [[drive1:][path1:] <filename1> + ...] 
[drive2:][path2:] <filename2> 


where: 
drivel = drive containing filenamel 
path1 = path containing filenamel 
filename1 = name of source file to be concatenated into 
filename2 
drive2 = drive containing filename2 
path2 = path containing filename2 
filename2 = name of target file to be created by COPY 
command 


5-53, 


MS-DOS Commands 


COPY 


and: 


<> = required information 
[] = optional information. 


Notes: 


Concatenating files is different from appending files to an 
existing file. Concatenation creates a new file (the last file 
named in the command) from the contents of all the 
previously named files. It does not change the contents of 
any existing file. 


Concatenating files into an existing file will destroy that 
file. COPY does not display an error message when this 
happens. 


When concatenating files, do not enter a plus sign 
between the last two file specifications. 


If the command line contains only two file specifications 
and the first filename specifies multiple files, you do not 
need to enter plus signs between the file specifications. 


EXAMPLES 


The command: 


copy city*.txt 3cities.txt 
py city 
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—_—._..4s ss 


concatenates CITY1.TXT, CITY2.TXT and CITY3.TXT into one 
file called 3CITIES.TXT. However, the command: 


copy city*.txt city3.txt 
py city y 


is a error which may destroy CITY3.TXT before it is 
concatenated into the new file. 


The command: 
copy cityl.txt + city2.txt city2.txt 


is an error which may destroy CITY2.TXT before it can be 
copied. 


5-55 


MS-DOS Commands 
cTTy 


CTTY (Change TeleTYpe device) 


PURPOSE 


Allows you to change the device from which you issue 
commands and to which you display information when using 
MS-DOS programs. This command is useful if you want to 
use a device other than the computer's keyboard and display 
screen for input and output. 


SYNTAX 
CTTY <device> 


where: 
device = device used to input and/or output 
and: 
<> = required information. 


COMMENTS 


The CITY command redirects all input and output control to 
the specified device, regardless of whether it is capable of 
performing both input and output. For example, if you 
specify a printer, MS-DOS will attempt to read input from the 
printer. This is not recommended. 


There are many programs that do not use MS-DOS for input, 
output, or both. These programs communicate directly with 
your computer's hardware and the CTTY command will not 
affect them. CTTY affects only those programs that use 
MS-DOS. 
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EXAMPLES 


To redirect input and output to a terminal or other device 
attached to the AUX port, type: 


ctty aux 


(MS-DOS usually defines the AUX port as your computer's 
built-in serial connector, which is also called COM1. The 
command CTTY COMI always uses the built-in serial 
connector. To define AUX to be another connector, use the 
redirect option, described in the MODE command section later 
in this chapter. 


To restore input from the computer's keyboard and output to 
the computer's display screen, type: 


ctty con 


(CON is an abbreviation for "console," a term from the early 
days of computers that refers to the keyboard and display 
screen.) 


The command: 
ctty nul 


disables all input and output. This is not recommended. 


Warning: You may not be able to return control to the 
keyboard and screen after typing ctty nul, except by 
restarting MS-DOS. 
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DATE 
—— Fe 


PURPOSE 


Enters or changes the system date, which is recorded in the 
directory for any files you create or change. 


SYNTAX 


DATE [mm-dd-yy] 


where: 
mm = 1-12 
dd = 1-31 
yy = 80-91 or 1980-1991 
and: 


[] = optional information. 


The date, month, and year entries may be separated by 
hyphens (-) or slashes (/). 


COMMENTS 
If you type: 


date 
DATE will respond with the message: 


Current date is mm-dd-yy 
Enter new date_ 


Press RETURN if you do not want to change the date shown. 
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You can also type a particular date after the DATE command, 
as in: 


date 3-9-81 


If you do not have an AUTOEXEC.BAT file, MS-DOS 
automatically asks you for the date and time when you start 
MS-DOS. MS-DOS does not ask you for the date if you have 
an AUTOEXEC.BAT file, unless your AUTOEXEC.BAT file 
includes a DATE command. 
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DEL (DELete) 
a a eee 


PURPOSE 
Deletes all files with the designated file specification. 
SYNTAX 
DEL [drive:][path] <filename> 
where: 
drive = drive containing file to be deleted 


path — path containing file to be deleted 
filename = file to be deleted 


and: 
<> = required information 
{] = optional information. 
SYNONYM 
ERASE 
COMMENTS 


If drive and/or path are not specified, the current drive 
and/or path is used. 


Wild-card characters (* and ?) are permitted in the filename. 


If the filename is *.*, the prompt: 
Are you sure? 


appears. You type y as a response, then all files in the current 
or specified directory are deleted. 
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—_—.oq 


Notes: 
Be careful. If you use wild-card characters in a filename, 


you may delete more files than you intended. For example 
the command: 


del a: *.* 
or 


erase a: *.* 


could delete all files in the current directory on drive A if 
you answer y to the prompt. 


You cannot delete read-only, system, or hidden files. 
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DIR (DIRectory) 


PURPOSE 


Lists the files and subdirectory names in a directory. 


SYNTAX 


DIR [drive:][path][filename] [/P][/W] 


where: 
drive = drive containing files and subdirectories to 
be listed 
path = path containing files and subdirectories to 
be listed 
filename = filenames to be listed 
and: 
[] = optional information. 
OPTIONS 


The /P option selects Page Mode. With /P, display of the 
directory pauses after the screen is filled. To resume display of 
output, press any key. 


The /W option selects wide display. With /W, only 
subdirectory names and filenames are displayed, without other 
file information. Directory entries are displayed five per line. 
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COMMENTS 


If you just type: 
dir 


all directory entries (files and subdirectory names) in the 
current directory on the default drive are listed. 


If you include a drive name, such as: 
dir b: 


all entries in the current directory of the disk in the specified 
drive are listed. 


If you enter only a filename with no extension, such as: 
dir name 


then all files with the designated filename in the current 
directory of the disk in the default drive are listed. 


When you type a filename with a drive letter, such as: 


dir b:name 


all files with the specified filename in the current directory on 
the disk in the specified drive are displayed. 
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In all cases, files are listed with their size in bytes and with 
the time and date of their last modification. Subdirectories are 
identified with a <dir> marker instead of a size. The 
directory listing also includes the volume label (if one exists), 
the amount of free space on the drive, and the total number of 
files in the directory. 


The wild-card characters ? and * (question mark and asterisk) 
may be used in the filename option. Note that the following 
DIR commands are equivalent: 


Command Equivalent 
dir dir *.* 

dir filename dir filename.* 
dir .ext dir *.ext 
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DISKCOMP (DISKette COMPare) 


—_— 


PURPOSE 


Compares the contents of the diskette in the first specified 
drive to the contents of the diskette in the second specified 
drive. DISKCOMP cannot be used to compare fixed disks or 
diskettes of different types. 


Notes: 
This command does not work over a network. 


This command does not work with drives that have been 
given aliases with the ASSIGN, JOIN, or SUBST 
commands. 


SYNTAX 
DISKCOMP [drive1:][drive2:] [/1][/8] 


where: 
drivel = drive containing first diskette 
drive2 = drive containing second diskette 
and: 
[] = optional information. 


OPTIONS 


The /1 option causes DISKCOMP to compare only the first 
side of the diskette, even if the diskette is double-sided. 


The /8 option causes DISKCOMP to compare only 8 sectors 
per track, even if the first diskette contains 9 or 15 sectors per 
track. 
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COMMENTS 


If you specify only one drive, DISKCOMP uses the current 

drive as the second specified drive. If you specify the same 
drive twice, DISKCOMP performs a comparison using that 

drive only, asking you to insert diskettes as needed. 


DISKCOMP automatically determines the number of sides and 
the number of sectors per track to be compared based on the 
first specified drive. If the two diskettes are not of the same 
type, DISKCOMP displays an error message. For more details, 
refer to the Tracks, Sectors, and Compatibility section of 
Chapter 2. 


DISKCOMP compares all tracks on a track-by-track basis and 
issues a message if the tracks are not equal. The message 
indicates the track number and the side (0 or 1) where the 
mismatch was found. 


If your computer has two diskette drives of the same type, the 
command: 


diskcomp a: b: 


compares the diskette in drive A to the diskette in drive B. 


If your computer has a single diskette drive, the command: 
diskcomp a: b: 


performs a single-drive comparison on two diskettes, asking 
you to insert either diskette as needed. DISKCOMP also 
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performs a single-drive comparison if the current drive is a 
diskette drive and you: 


* Specify no diskette drive 

* Specify one diskette drive 

* Specify the same diskette drive twice. 
Note: If you created the second diskette using the COPY 
command, DISKCOMP will usually display a compare 
error message when you compare the first and second 
diskettes. This is because COPY does not necessarily put 
the information in the same place on the target diskette. 
You should use COMP to compare files you’ve copied with 


the COPY command, and DISKCOMP to compare diskettes 
you've copied with the DISKCOPY command. 


For more information about DISKCOMP, refer to the 
Comparing Diskettes section of Chapter 4. 


FOR BATCH PROGRAMMERS 
The DISKCOMP command returns the following error-level 
codes: 
0 Compared OK. 
1 Did not compare. The diskettes were not the same. 


2 CTRL-C error. The user terminated the operation with 
CTRL-C. 


3 Hard error. An unrecoverable read or write error 
occurred, and the diskettes did not compare. 


4 Initialization error. There is not enough memory— 
invalid drives or command line syntax. 
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DISKCOPY (DISKette COPY) 


PURPOSE 


Copies the contents of the diskette in the source drive to the 
diskette in the target drive. DISKCOPY cannot copy to or 
from fixed disks or diskettes of different types. 


Notes: 
This command does not work over a network. 


This command does not work with drives that have been 
given aliases with the ASSIGN, JOIN, or SUBST 
commands. 


SYNTAX 
DISKCOPY [drivel:][drive2:] [/1] 


where: 
drivel = drive containing source diskette 
drive2 = drive containing target diskette 
and: 
[] = optional information. 


OPTION 


The /1 option causes DISKCOPY to copy only the first side of 
the source diskette, even if it is double-sided. 


COMMENTS 


If the target diskette is unformatted, DISKCOPY formats it in 
the same format as the source diskette before continuing. 
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You are prompted to insert the disks at the appropriate times. 
DISKCOPY waits for you to press any key before continuing. 


If you omit both drive letters, a single-drive copy operation is 
performed on the default diskette drive. 


If you omit the second drive letter, the default drive is used as 
the target diskette drive if the default drive is a diskette drive. 


If you specify the same diskette drive twice, a single-drive 
copy operation is performed. 


DISKCOPY figures out the number of sides, tracks, and sectors 
to copy, based on the source drive and disk. Refer to the 
Tracks, Sectors, and Compatibility section of Chapter 2 for 
more information. 


When disks have had a lot of files created and deleted on 
them, files become fragmented, because disk space is not 
allocated sequentially. The first free sector found is the next 
sector allocated, regardless of its location on the disk. 


Fragmented files can cause slowness due to delays in finding, 
reading, or writing a file. If this is the case, you should use the 
COPY or XCOPY command, instead of DISKCOPY, to copy 
your disk. Because COPY and XCOPY copy files sequentially 
to a disk, the new files will not be fragmented. 
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FOR BATCH PROGRAMMERS. 
The DISKCOPY command returns the following error-level 
codes: 
0 Copied successfully. The last diskette copy was 
completed with no errors. 


1 Nonfatal read/write error. An unrecoverable but 
nonfatal read or write error occurred. 


2 The user terminated the operation with CTRL-C. 


3 Fatal hard error. DISKCOPY was unable to read the 
source diskette or format the target diskette. 


4 Initialization error. There is not enough memory— 
invalid drives or command line syntax. 
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DRIVER.SYS 


— oS 


DRIVER.SYS is a device driver program that supports external 
drives. If you have more than four diskette drives or two fixed 
disk drives connected to your computer, you must install 
DRIVER.SYS so that MS-DOS can recognize and use them. For 
more information, see Appendix H, DRIVER.SYS. 
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EXE2BIN (EXEcutable to BINary) 


PURPOSE 
Converts .EXE (executable) files to binary file format. 
Using EXE2BIN results in faster program loading and 


conserves space on the disk. For information about EXE2BIN, 
see Appendix F, EXE2BIN. 
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EXEC (EXECute) 
—— ee 


PURPOSE 


Performs any specified MS-DOS command on those files 
which have previously been tagged using the TAG command. 


EXEC, and its companion commands TAG and UNTAG, let a 
single MS-DOS command operate on multiple files without 
restrictions on filenames, regardless of which directories 
contain the files. 


For more information, refer to the TAG and UNTAG command 
descriptions in this chapter. 


SYNTAX 
EXEC <MS-DOS-cmd-name> [$$] [cmd-options] 


where: 
MS-DOS- 
cmd-name = any valid MS-DOS command, executable 
program, or batch program 
and: 
<> = required information 
[] = optional information. 


Notes: 


The above syntax line applies to all MS-DOS commands 
where the command options follow the filename. This is 
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usually the case. For commands such as FC and FIND, 
where options precede the filename, use the syntax: 


EXEC <MS-DOS-cmd-name> [cmd-options][$$] 


The <MS-DOS-cmd-name> string can be any valid 
MS-DOS command, executable program or batch program 
with one of these extensions: .COM, .EXE, or .BAT. 


OPTIONS 


Where <MS-DOS-cmd-name> is any command or batch 
program that accepts an argument of one or more filenames, 
use $$ as a placeholder where the source filename, including 
drive and path specifications, is usually entered. Do not use $$ 
if the command does not require or allow you to specify 
filenames. 


EXEC executes the <MS-DOS-cmd-name> command once 
for each tagged file. If $$ appears on the command line, EXEC 
substitutes the name of each tagged file, in turn, for $$ before 
executing the specified command. 


The [cmd-options] string contains any valid options you wish 


to use with <MS-DOS-cmd-name>. 


COMMENTS 


You can EXEC(ute) any MS-DOS command, executable 
program, or batch file (with a .BAT extension) except EXEC. 
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The command: 
exec exec 


has no function, with or without options. 
Notes: 


When, and only when, you use EXEC to execute an 
MS-DOS command involving redirection, you must put 
the redirection symbol in double quotes. For example, 


exec type $$ ">>" bigfile 


appends each tagged file to BIGFILE. If you omit the 
double quotes, your redirected output will consist of 
messages generated by EXEC instead of the output from 
the command you are executing. In the example above, 
you would add a number of EXEC messages to BIGFILE 
instead of the contents of the tagged files. 


When, and only when, you use EXEC to execute the FIND 


command, you must put the string to be sought for in 
single quotes. For example, 


exec find ‘September’ $$ 


finds the string "September" in each tagged file. 


If a file has been tagged and then hidden using the 
CHMOD command, EXEC will not operate on that file 
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EXEC 
unless the MS-DOS command (for example, CHMOD) can 
operate on hidden files. 

EXAMPLES 


Suppose you have previously tagged a number of files with 
the TAG command. To copy them to the \TEST directory on 
the diskette in drive B (with verification), type: 


exec copy $$ b:\test /v 


Note: This command copies every tagged file, regardless 
of its name, drive, or directory, to the \TEST directory on 
drive B. Compare this with the command: 


copy *.tst b:\test /v 


which copies only those files with the extension .TST in 
the current directory to the \TEST directory on drive B. 


To compare each tagged file with the TESTFILE.DOC file on 
the diskette in drive B (ignoring case and multiple spaces), 


type: 
exec fc /c/w $$ b:\testfile.doc 


Note: In this example, the command options precede the 
$$ string because the FC command requires options to be 
entered before filenames. 
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To delete all of the tagged files, type: 


exec del $$ 


Note: Deleting a file does not untag that file. The only 


way to untag a file is with the UNTAG command, 
described in this chapter. 


EXEC may also be combined with command names that do not 
require you to specify filenames. For example, 


exec command 


opens a series of command processors, one for every tagged 
file. 
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EXIT 


PURPOSE 


Exits the program COMMAND.COM (the command processor) 
and returns to a previous command processor, if one exists. 


SYNTAX 


EXIT 


COMMENTS 


If you have invoked a new command processor, type: 
exit 


to return to the previous level. You can use EXIT to return to 
MS-DOS or to an application program. Typing: 


exit 


without a previous COMMAND has no effect. 


For more information, refer to the COMMAND section of this 
chapter. 
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FC (File Compare) 


PURPOSE 


Compares the contents of two files. It gives a more complete 
description of the differences between two files than the 
COMP command. If you have copied a file and modified the 
copy, FC can check the changes you have made and output the 
differences between the two files to the screen or to a third 
file. 


FC compares files on either a line-by-line or a byte-by-byte 
basis. The line-by-line comparison isolates blocks of lines that 
are different between two files and prints those blocks of lines. 
You use this type of comparison to check for differences in 
text files. The byte-by-byte comparison displays the bytes that 
are different between two files. You use this type of 
comparison to check for differences in binary files. 


SYNTAX 


FC [/A][/B][/C][/L][/LBa][/N][/T][/W][/nnnn] 
[drive:1][path1] <filename1 > [drive2:][path2] <filename2> 


where: 
drivel = drive containing first file 
path1 = path containing first file 
filenamel = first file to be compared 
drive2 = drive containing second file 
path2 = path containing second file 
filename2 = second file to be compared 
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and: 


<> = required information 
[] = optional information. 


Note: Wild-card characters are not permitted in filenames. 


OPTIONS 


The /A option causes FC to abbreviate the output of a line- 
by-line comparison. Instead of displaying all of the lines that 
are different, only the lines that begin and end each set of 
differences are displayed. The intermediate lines are 
represented by ellipses (...). 


The /B option causes FC to perform a binary comparison of 
both files. The two files are compared byte-by-byte with no 
attempt to re-synchronize after a mismatch. Mismatches are 
printed as follows: 


--ADDRS----F1----F2- 
AXXXXXX yy zz 


where xxxxxxx is the relative address of the pair of bytes from 
the beginning of the file. Addresses start at 0000000; yy and 
zz are the mismatched bytes from filel and file2, respectively. 
FC displays all values in hexadecimal notation. 


If one of the files contains less data than the other, a message 


appears. For example, if Fl ends before F2, the following 
message appears: 


fe:F2 longer than F1 
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The /B option is automatically used when you compare files 
with the extensions .EXE, .COM, .SYS, .OBJ, .LIB, or .BIN. 


The /C option causes FC to ignore the cases of letters. All 
letters in the files are considered uppercase. Use only in 
source or text comparisons. 


The /L option causes FC to perform a line-by-line comparison. 
The /L option is automatically used when files to be compared 
have extensions other than .EXE, .COM, .SYS, .OBJ, .LIB, or 
-BIN. 


The /LBn option causes FC to set the internal line buffer to 
<n> lines. The default length of the internal buffer is 100 
lines. 

If the number of lines in the internal buffer is less than the 
number of consecutive, differing lines, the program will stop. 
FC displays: 


resynch failed. Files are too different. 


and returns to the MS-DOS prompt. 


The /N option causes FC to display the line numbers on a 
line-by-line comparison. 


The /T option causes FC to expand tabs to spaces. The default 
is to treat tabs as spaces to 8-column positions. 


The /W option causes FC to compress whitespace (tabs and 
spaces) during comparison. Multiple contiguous whitespace in 
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any line is considered as a single whitespace. Only beginning 
and ending whitespaces are ignored. Use only in source or 
text comparisons. 


The /nnnn option specifies the number of lines required to 
match for the files to be considered as matching again after a 
difference has been found. It can be any number from 1 to 
9,999. If this number is not specified, it defaults to 2. 


EXAMPLES 


Assume these two ASCII files are on disk: 


ALPHA BETA ALPHA BETA 


A A BP, S 
B B Q T 
Cc ¢ R U 
D G S Vv 
E H T 4 
F I U 5 
G J v Ww 
H 1 Ww x 
I 2 X Y 
M F ¥ Zz 
N Q Zz 

1e} R 


One way to compare them is: 


fc alpha beta 
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FC compares the two files and displays the differences on the 
screen. All defaults remain intact. The output appears as 
follow: 


NOTE: ALPHA file contains 


—_—______ALPHA. ASM 

D 

E DEFG,BETA contains G 
F 

G 

—_______BETA.asM 

G 


M NOTE: ALPHA contains MNO, 
N BETA contains J12 
° 
P 


Ww NOTE: ALPHA contains W, 
BETA contains 45W 
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If you use: 
fc /b alpha beta 


The following binary comparison appears: 


—ADDRS— -F1— —F2— 
00000009 44 47 
0000000c 45 48 
0000000F 46 49 
00000012 47 4A 
00000015 48 31 
00000018 49 32 
0000000B 4D 50 
0000001E 4E 51 
00000021 4P 52 
00000024 50 53 
00000027 4 54 
0000002A 52 55 
0000002D 53 56 
00000030 54 34 
00000033 55 35 


*** DATA left in F1 s##« 


To compare FILE1.TXT and FILE2.TXT and then send the FC 
output to DIFFER.TXT, type: 


fc file1.txt file2.txt > differ.txt 


The differences and matches between FILE1.TXT and 
FILE2.TXT will be put into DIFFER.TXT on the default drive. 
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FDISK (Fixed DISK setup) 
———— ee 


PURPOSE 


The FDISK command lets you create and delete up to four 
partitions on a fixed disk drive for MS-DOS, MS-DOS data, 
and another operating system. 


SYNTAX 
FDISK 


COMMENTS 


For complete information refer to Using a Fixed Disk Drive 
in Chapter 3. 
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FIND 


PURPOSE 


Searches for a specific string of text in a file or files. FIND is 
an MS-DOS filter. It will display all lines that contain a 
specified string (group of characters) from the files in the 
command line. 


SYNTAX 
FIND [/V][/C][/N] <'string"> [[drive:][path][filenamel...] 


where: 
string = string of text to be found 
drive = drive containing file to be searched 
path = path containing file to be searched 
filename = file to be searched for string 


<> = required information 


[] = optional information. 


Note: Wild-card characters are not allowed in filenames. 


OPTIONS 
The /V option causes FIND to display all lines not containing 
the specified string. 


The /C option causes FIND to print only the count of lines 
that contained a match in each of the files. 


The /N option causes FIND to precede each line by its relative 
line number in the file. 
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COMMENTS 


If no filenames are typed, FIND takes standard input from the 
keyboard and displays all lines that contain the specified 
string. 

The string must be enclosed by double quotation marks. Case 
is important; FIND will not match upper-case letters with the 
corresponding lower-case letters, and vice versa. 


FIND searches the file up to the first end-of-file character 
(CTRL-Z). 


EXAMPLES 


The command: 
find "Fool’s Paradise" book1.txt book2.txt 


displays all lines from BOOK1.TXT and BOOK2.TXT (in that 
order) that contain the string "Fool’s Paradise." 


The command: 
dir b: | find /v "date" 


displays all names of the files on the diskette in drive B that 
do not contain the string "date." 
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If a string contains double quotes, type two consecutive 
double quotes to search for it. For example, 


find "your "hello world" program" go.bat 


displays all lines from the file GO.BAT that contain the string 
"your "hello world" program". 
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FORMAT 


SS 


PURPOSE 
Formats the disk in the specified drive to accept MS-DOS files. 


Warning: Formatting destroys any previously existing data 
ona disk. Be very careful when formatting a disk, 
especially a fixed disk. 


SYNTAX 
FORMAT <drive:> [/1] (/4] [/8] [/V] (/S] /N:<nns>] 
UT: <tt>] 
where: 
drive = drive containing disk to be formatted 
and: 
<> = required information 
{) = optional information. 
Notes: 


This command initializes the directory and file allocation 
tables on disk. You must use this command to format all 
new MS-DOS fixed disk partitions and diskettes before 
MS-DOS can use them. 


FORMAT ignores drive assignments created with the 
ASSIGN command. 


You should not use FORMAT with drives that have been 
given aliases with the ASSIGN, JOIN, or SUBST 
commands. 


You cannot format drives over a network. 
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OPTIONS 


The following table shows which options you can use for 
certain types of disks: 


Disk Type | Valid Options 


160/180-Kb | /1 /4 /8 Iv /s 
320/360-Kb | /1 /4 /8 Iv Is 


720-Kb lv Is 
1.2-Mb lv Is 
Fixed disk lv Is 


The /1 option formats a disk for single-sided use, even if the 
disk or drive is double-sided. If the drive is double-sided and 
you do not specify this option, you will not be able to use it in 
a single-sided drive. 


The /4 option formats a 360-Kb disk in a 1.2-Mb disk drive. 
You should note that you may not be able to read disks 
formatted with this option reliably in a 360-Kb drive. 


The /8 option formats a disk for 8 sectors per track. If you do 
not specify this option, FORMAT defaults to either 9 or 15 
sectors per track (depending on the type of drive being used). 


Note: For more information, refer to the Tracks, Sectors, 
and Compatibility section of Chapter 2. 


The /V option causes FORMAT to prompt for a volume label 
after the disk is formatted. A volume label can be up to 11 
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characters long and is used to identify the disk. An example 
of a volume label is PROGRAMS. 


If the /S option is specified, FORMAT copies operating system 
files from the disk in the default drive to the newly formatted 
disk. The files are copied in the following order: 


IBMBIO.COM 
IBMDOS.COM 
COMMAND.COM 


The /N: option specifies the number of sectors per track to be 
provided on the floppy disk. This option is used with the /T: 
option to specify a disk size other than the maximum capacity 
of the drive. Valid values for <nn> are 8, 9, and 15. 


The /T: option specifies the number of tracks to be provided 
on the floppy disk. This option is used with the /N: option to 
specify a disk size other than the maximum capacity on the 
drive. Valid values for <tt> are 40 and 80. 


COMMENTS 


FORMAT uses the drive type to determine the default format 
for a disk. 


When you format a fixed disk, FORMAT prompts you with the 
following: 


Enter current Volume Label for drive (x:) 


Press RETURN if your fixed disk does not have a volume label. 


Note: If your fixed disk has never been formatted before, 


MS-DOS Commands 
FORMAT 


saa EEEEEEmeeesesieeeeee 


or if it has a bad boot sector, FORMAT will not prompt 
you for a volume label. 


If the volume label that you enter does not match the label on 
the fixed disk, FORMAT displays the message: 


Invalid Volume 1D 
Format failure 


Otherwise, FORMAT continues: 


WARNING, ALL DATA ON NON-REMOVABLE DISK DRIVE x: 
WILL BE LOST! 
Proceed with Format (Y/N)? 


If you want to format your fixed disk, type: 


y 


and press RETURN. If you do not want to format your fixed 
disk, type: 


n 
and press RETURN. 


If MS-DOS isn’t on the default drive, FORMAT prompts you 
to insert a system disk in the default drive (or in drive A if the 
default drive is a nonremovable drive). 


When formatting is complete, FORMAT displays a message 

showing the total disk space, any space marked as defective, 
the total space used by the operating system (when you use 
the /S option), and the space available for your files. 
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FOR BATCH PROGRAMMERS 
The FORMAT command returns the following error level 


codes: 


0 
3 
4 
5 


Successful completion. 
Terminated by user (CTRL-C). 
Fatal error (any error other than 0, 3, or 5). 


"N" response to fixed disk prompt, "Proceed with 
format (Y/N)?" 


EXAMPLES 


The command: 


C> format a: 


will format the diskette in drive A. (C> is the hard disk drive 
prompt.) 


The command: 


A> format b: /s 


will format the diskette in drive B and then copy the system 
files from the system diskette in drive A. (A> is the drive A 


prompt.) 


The command: 


A> format b: /N:9 /T:80 


will format a 720 Kb diskette in a 1.44 Mb capacity drive B. 
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GRAPHICS 


PURPOSE 


Enables you to print a graphics display screen on an AT&T 473 
Graphics Printer or an AT&T 477 Graphics Color Printer or 
any printer compatible with either. 


SYNTAX 
GRAPHICS [ {GRAPHICS} {COLOR} ][/R][/B] 


where: 
[] = optional information 
0) = either/or. 


OPTIONS 
The GRAPHICS option is used with the AT&T 473 Graphics 
Printer and compatibles (the default type). 


The COLOR option is used with the AT&T 477 Graphics Color 
Printer and compatibles. 


The /R option causes black on the display screen to be printed 
black. The default is to print white on the screen as black on 
the printer, and vice versa. 


The /B option prints the background. It is valid for the color 
printer only. 


COMMENTS 


GRAPHICS is a memory-resident program using about 12 Kb 
of memory. 
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To print a graphics display: 


i) Type the GRAPHICS command with the desired 
options. 


2 Produce the desired graphics display on the screen 
3. Press SHIFT-Prt Sc. 


Note: The GRAPHICS command defaults to a 
standard parallel printer. If your printer requires 
other communications parameters, set them with the 
MODE command before using GRAPHICS. 


To change GRAPHICS options, type a new GRAPHICS 
command at the MS-DOS prompt. 


Color images will be printed in up to four shades of gray if 
you use either of these combinations or equipment: 


° The standard PC video display board and AT&T 473 
Graphics Printer 


° The AT&T Display Enhancement Board (DEB) and 
AT&T 477 Graphics Color Printer. 
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HELP 


PURPOSE 


Displays help information on a specified topic or displays an 
index of available topics. 


SYNTAX 
HELP [category][topic] 
where: 
category = a group of related topics 
topic = an MS-DOS command or related topic 


and: 
[] = optional information. 


COMMENTS 


Refer to Chapter 7, Getting Help, for complete information on 
the MS-DOS help facility. 


USING TOPICS 
To display an index of available help topics, type: 


help 


and press RETURN. 
To choose a topic from the topic index: 


© Use the cursor control keys ({, |, —, or —) to highlight 
the topic name and press RETURN, or 
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* Type the topic name in response to the prompt: 
Enter topic name: 


and press RETURN. 


You can display help information directly from the MS-DOS 
Prompt (bypassing the topic index), by specifying a topic name 
as an argument. 

USING CATEGORIES 


AT&T has provided a category called DOS which contains 
help information about MS-DOS commands and other subjects 
related to MS-DOS. The category specification only applies if 
you add other sets (categories) of help topics in addition to the 
DOS category. 


If you have added other categories of help topics, typing: 
help 


and pressing RETURN produces a category index. 
To choose a category from the category index: 


*° Use the cursor control keys (f, |, —, or ) to highlight 
the category name and press RETURN, or 
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* Type the category name in response to the prompt: 
Enter category name: 


and press RETURN. 


Upon choosing a category, the topic index for that 
category is displayed. Choose a topic from the topic 
index as described above. 


Alternatively, you can display a topic index directly 
from the MS-DOS prompt (bypassing the category 
index), by specifying the category name as an argument 
to HELP. 


Finally, you can display help information from multiple 
categories, bypassing both the category and topic indexes, by 
specifying both a category name and topic name as arguments 
to the HELP command. If you specify both arguments, you 
must type the category name before the topic name. 


DISPLAYING INFORMATION 


Once help information on a topic is displayed, you can use PG 
UP, PG DN, HOME, and END to display the next, previous, first, 
and last screenfuls of text on that topic. 


To exit to the MS-DOS prompt from any help screen, press 
CTRL-END. 
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EXAMPLES 
When only one category exists (the DOS category), the 
command: 


help copy 


displays help information about the COPY command. 


If you have added other categories of help topics, the 
command: 


help dos 


displays the DOS topic index. 


The command: 
help dos format 


displays help information about the FORMAT command in the 
DOS category. 
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JOIN 


PURPOSE 


Joins a disk drive to a specific unused pathname on a different 
drive. JOIN lets you consider a diskette drive or other device 
as a subdirectory of a fixed disk. 


Note: Do not use JOIN with a drive that has been given 
an alias with the ASSIGN or SUBST commands. 


SYNTAX 
JOIN <drive:1> <drive2:><path> [/D] 


where: 
drivel = a diskette drive 
drive2 = a fixed disk 
path = an empty subdirectory of the root on drive 2 
and: 
<> = required information 
[] = optional information. 


OPTIONS 


To turn off JOIN, use the following format: 
join <drive:> /d 


where <drive:> represents the first drive and the /D option 
turns off the JOIN command. If you just type: 


join 


5-100 


MS-DOS Commands 
JOIN 


MS-DOS displays the current drives that are joined. 


COMMENTS 


JOIN lets you consider one or more diskette drives, fixed disk 
Partitions, RAM disks, or network drives as subdirectories of a 
single fixed disk. Any subsequent MS-DOS command that 
references the files on the fixed disk also references the files 
on the joined drives. 


If the path does not exist, MS-DOS tries to make a directory 
with that path. 


After you issue the JOIN command, the first drive name 


becomes invalid; and if you try to use it, MS-DOS displays the 
error message: 


Invalid drive 


If the path already existed before the JOIN command was 
typed, it will not be usable while the join is in effect. The 
path must be empty. 


You can only join a drive at the root. The following command 
will work: 


join b: c:\memos 
The following command will NOT work: 


join b: c:\memos\june 
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The commands: 


join a: c:\drivea 
join b: c:\driveb 


permit both diskette drives to be treated as subdirectories of 
fixed disk drive C. If you then enter the command: 


tree c: *.doc 


the output from TREE then includes all of the *.DOC files on 
the diskettes in both drives as well as those on the fixed disk. 


Also refer to the SUBST command description later in this 
chapter. 
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LABEL 
a  , 


PURPOSE 


Allows you to create, change, or delete a volume label on a 
disk. 


Notes: 
This command does not work over a network. 


You cannot use LABEL with drives that have been given 
aliases using the ASSIGN or SUBST commands. 


SYNTAX 
LABEL [drive:][volume-label] 


where: 
drive = drive containing disk to be labeled 
volume-label = a string of up to 11 characters 
and: 
[] = optional information. 


OPTIONS 


The [volume-label] option can contain up to 11 characters, 
excluding these: 


“2 Nk et = <0 


and the tab and blank space characters. 


Do not type spaces between the drive letter, colon, and 
volume label. 
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COMMENTS 


If you do not specify a volume-label, you are prompted with 
the following message: 


Volume label (11 characters, ENTER for none)? 


To give the disk a volume label, type the label you want and 
press RETURN. 


To change an existing volume label, type the new volume label 
and press RETURN. The new label you type replaces the 
existing volume label. 


To delete a volume label, do not specify a volume label; just 
press RETURN. The volume label on the disk is deleted. 


Note: If you type more than 11 characters for the volume 
label, only the first 11 characters are used. 
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LINK is an executable program that combines object modules that 
are the output of the MACRO-86 assembler or a compatible 
compiler. For more information, see Appendix C, LINK. 
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MKDIR (MaKe DIRectory) 


PURPOSE 


Creates a subdirectory on the specified disk. MKDIR can be 
used to create a hierarchical directory structure. 


SYNTAX 
MKDIR [drive:] <path> 


where: 
drive = drive where subdirectory is to be created 
path = name of subdirectory 
and: 
[] = optional information. 


SYNONYM 
MD 


COMMENTS 


Notes: 


Pathnames entered with this command can contain up to 
63 characters, including backslashes. Rules for creating 
pathnames are the same as rules for filenames. (Refer to 
Files section in Chapter 2 for more information.) 


Typing a backslash (\) before the subdirectory name will 
create that subdirectory under your root directory, instead 
of your current directory. 
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EXAMPLES 


The command: 


mkdir \user 
or 


md \user 


will create a subdirectory \USER in your root directory. 


To create a directory named JOE under \USER when you are 
in your root directory, type: 


mkdir \user\joe 
You can create the same subdirectory by typing: 


chdir user 
mkdir joe 
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MODE 


PURPOSE 


Lets you define certain operating characteristics of your 
computer's display, printer, and communications ports. The 
MODE command has four format options. Any missing or 
invalid parameter will leave that parameter unchanged. 


SETTING THE PARALLEL PRINTER 


Note: For serial printers, see Setting the Serial Port. 


SYNTAX 
MODE LPT <#>:{c][.[m]LP]] 
where: 
# = printer number 1, 2, or 3. 
and: 


<> = required information 
[] = optional information. 


Note: Do not type spaces after LPT. 


Options 


The c option generates 80 or 132 characters per line. 
The m option generates 6 or 8 lines per inch vertical spacing. 


The P option causes MODE to continuously retry to send 
output to the printer when time-out errors occur. To stop the 
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loop, press CTRL-BREAK. To turn off the option, enter 
another MODE command for this printer without typing the P 
option. 


Note: Default options at power-on for the printer are 

LPT1, 80 characters per line, and 6 lines per inch. 
EXAMPLE 

mode Ipt1:132,8 


will set the mode of operation for printer 1 to 132 characters 
per line and 8 lines per inch spacing. 


SETTING THE SERIAL PORT 
These instructions are for a serial port (for example, a serial 


printer or modem). 


Note: For parallel printers, see Setting the Parallel 
Printer. 


SYNTAX 


MODE COM<n>:<baud> [,parity[,databits 
[stopbits{,P]]]] 


where: 
<> = required information 
[] = optional information. 
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Note: Do not type spaces after COM. 
Options 


The n option is either 1 or 2 (serial port number; default = 1). 


The baud option is 110, 150, 300, 600, 1200, 2400, 4800, or 9600 
(no default). 


Note: Only the first two characters of the baud rate 
number are required; the subsequent characters are 
ignored. 


The parity option is either N (none), O (odd), or E (even)— 
(default = E). The databits option is either 7 or 8 
(default = 7) 


The stopbits option is either 1 or 2 (if baud equals 110, 
default = 2; if baud does not equal 110, default = 1). 


The P option causes MODE to continuously retry to send 
output to the printer when time-out errors occur. To stop the 
loop, press CTRL-BREAK. To turn off the option, enter 
another MODE command for this printer without typing the P 
option. 


These communications protocol parameters are used to 
initialize the serial port. When you specify the parameters, 
you must at least specify the baud rate. The other parameters 
can be omitted with the defaults accepted, by entering only 
commas. 
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EXAMPLES 
Typing: 


mode com1:12,n,8,1,p 


sets the mode of operation to 1200 baud rate, no parity, eight 
databits, and one stopbit. Time-out errors are continuously 
tried. 


To use the defaults listed in the definition above, you enter: 
mode com1:12,,,,p 


The parity defaults to even, the databits defaults to seven, and 
the stopbits defaults to one. Time-out errors are continuously 
retried. 


If you change a parameter that is mentioned late in the list, 
you must enter the intervening commas. 


Note: You can abbreviate this command, for example: 
mode com1:30 


changes the baud rate to 300 and leaves all other options 
as they were. 
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SETTING THE DISPLAY MODE 


SYNTAX 


MODE [n][(R} (LET) 


where: 


Options 


[] = optional information 
= either/or. 


n may be 40, 80, BW40, BW80, CO40, CO80, or MONO: 


40 — Sets the display width to 40 characters per line 
© 80 — Sets the display width to 80 characters per line. 


BW40 — If you have a monochrome and a color 
display attached to your computer, selects the color 
display to be active, sets the display mode to black and 
white, and sets the display width to 40 characters per 
line. 


BW80 — If you have a monochrome and a color 
display attached to your computer, selects the color 
display to be active, sets the display mode to black and 
white, and sets the display width to 80 characters per 
line. 


C040 — If you have a monochrome and a color display 
attached to your computer, selects the color display to 
be active, sets the display mode to color, and sets the 
display width to 40 characters per line. 
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* CO80 — If you have a monochrome and a color display 
attached to your computer, selects the color display to 
be active, sets the display mode to color, and sets the 
display width to 80 characters per line. 


° MONO — If you have a monochrome and a color 
display attached to your computer, selects the 
monochrome display to be active. The width for 
monochrome displays is always 80 characters per line. 

The R option shifts the display right. 
The L option shifts the display left. 


The T option requests a test pattern for use in aligning the 
display. 


For readability, the display can be shifted to the right or left 
(one character for 40 columns or two characters for 80 
columns). If the T parameter is specified, a prompt asks you if 
the screen is properly aligned. Typing: 

nd 
will end the command. Typing: 


n 


will shift the display again in the same direction and the 
prompt is also displayed again. For example: 


mode 80,1,t 


5-113, 


MS-DOS Commands 
MODE 


sets the mode of operation to 80 characters per line and shifts 
the display two character positions to the left. The test pattern 
is again displayed to allow you to shift the display again. 


REDIRECTING OUTPUT 

This option redirects parallel printer output to a serial port. 
SYNTAX 

MODE LPT<#>:=COM<n> 

where: 


# 
n 


printer 1, 2, or 3 
serial port 1 or 2. 


All output directed to printer LPT# will be redirected to serial 
port n. 


Notes: 

Before you can use MODE to redirect parallel printer 
output to a serial device, you must first initialize the serial 
port using a MODE command (serial port option). If that 
serial device is a printer, your serial initialization 


command should also include the P parameter. 


A MODE command of the form: 
MODE LPT<#>:[c][,[m][P]] 


directs parallel printer output back to the parallel printer. 
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PURPOSE 


Sends output to the console one screen at a time. MORE is an 
MS-DOS filter. 


SYNTAX 
MORE 


COMMENTS 
MORE reads from standard input and displays one screen of 
information at a time. The MORE command pauses and then 
displays 
--More-- 


at the bottom of your screen. 


Pressing RETURN displays another screen of information. This 
process continues until all the data has been read. 


The MORE command is useful for viewing a long file one 
screen at a time. If you type: 


type myfiles.new | more 


MS-DOS will display the file MYFILES.NEW one screen at a 
time. 
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Note: You can also use the < redirection symbol to 
redirect the contents of a file through MORE. For 
example: 


more <myfiles.new 
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PURPOSE 


Sets a command search path for executable files (files with the 
filename extensions .COM, EXE, or .BAT). 


Note: To set a search path for files that are not executable, 
use the APPEND command, described later in this chapter. 


SYNTAX 
PATH [=drive:][path][,[drive:][path]...] 


where: 
drive = drive to be searched 
path = path to be searched 
and: 


8] 


optional information. 


COMMENTS 


This command allows you to tell MS-DOS which directories 
should be searched for external commands or other executable 
files after MS-DOS searches your current directory. The 
default value is no path. 


You can type either an equal sign (=) or a space after the word 
PATH. If you use an equal sign, do not add spaces. 


To tell MS-DOS to search the \USER\JOE directory for external 
commands, type: 


path \user\joe 
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SEE 


MS-DOS now searches the \USER\JOE directory for external 
commands until you set another path or exit MS-DOS. 


You can tell MS-DOS to search more than one path by 


specifying several pathnames separated by semicolons. For 
example: 


path \user\joe;b:\user\sue;\bin\dev 


tells MS-DOS to search the directories specified by the above 
pathnames to find external commands. MS-DOS searches the 
pathnames in the order specified in the PATH command. 


The command PATH with no options will print the current 
path. 


If you specify: 
path ; 


MS-DOS will set the NUL path. This means that only the 
current directory will be searched for external commands. 


You may want to include a PATH command in your 
AUTOEXEC.BAT file so that the command search path will be 
set whenever you start up your computer. 
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PURPOSE 


Prints text files on a printer while you are processing other 
MS-DOS commands (usually called "background printing"). 
Use the PRINT command only if you have a printer attached 
to your computer. 


SYNTAX 


PRINT [drive:][path]<filename> [/D:<device>][/B:<size>] 
[/Q:<value>][/T][/C]/P][[drive:][path] <filename> 
[/C][/P]...] 


where: 
drive = drive containing file to be printed 
path = path containing file to be printed 
filename = name of file to be printed 
and: 
<> = required information 
[] = optional information. 


OPTIONS 


The/D (Device) option specifies the print device. If not 
specified, the default device is PRN. Other devices are LPT1, 
LPT2, LPT3, AUX, COM1, or COM2. PRINT prompts for a 
print device. (This option is allowed only the first time you 
run the PRINT command after starting MS-DOS.) 


The /B (Bytes) option sets the size in bytes of the internal 
buffer. The default is 512 bytes. Increasing the value of /B 
speeds up the PRINT command. (This option is allowed only 
the first time you run the PRINT command after starting 
MS-DOS.) 
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The /Q (Queue) option specifies the number of files allowed 
in the print queue if you want more than 10. The minimum 
value for the /Q option is 4; the maximum is 32. (This option 
is allowed only the first time you run the PRINT command 
after starting MS-DOS.) 


The /T (Terminate) option deletes all files in the print queue 
(those waiting to be printed). MS-DOS prints: 


PRINT queue is empty 


The /C (Cancel) option turns on cancel mode. The filename 
preceding /C and all filenames following /C (up to, but not 
including, the filename preceding /P) are removed from the 
print queue. 


The/P (Print) option turns on print mode. The filename 
preceding /P and all filenames following /P (up to, but not 
including, the filename preceding /C) are then added to the 
print queue. 


If you use PRINT without options, it displays the contents of 
the print queue on your screen without affecting the queue. 


COMMENTS 


You can specify multiple files for printing, each with the 
desired options, in one PRINT command. Wild-card characters 
are allowed in filenames. 
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EXAMPLES 


The command: 
print /t 


empties the print queue. 


The command: 
print a:temp1.tst /c a:temp2.tst /P a:temp3:tst 


removes TEMP1.TST from the queue, and adds TEMP2.TST 
and TEMP3.TST to the queue. 


Note: Each print queue entry may contain a maximum of 
64 characters, including the drive name. Therefore, you 
may need to change directories if you want to print files 
in deep subdirectories. 
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PURPOSE 
Changes the MS-DOS command prompt. 


SYNTAX 
PROMPT [promptext] 


where: 
promptext = text and special strings as defined below 
and: 
{] = optional information. 


COMMENTS 


This command allows you to change the MS-DOS system 
prompt (for example, A>). If no text is typed, the prompt will 
be set to the default prompt, which is the default drive 
designation. You can set the prompt to a special prompt, such 
as the current time, by using the character strings indicated 
below. Letters in the character strings can be uppercase or 
lowercase. 


The following character strings can be used in the prompt 
command to specify special prompts. They must all be 
preceded by a dollar sign ($): 


String Specifies This (Prompt): 


$$ ’$’ character 
St current time 
$d current date 
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$p current directory of the default drive 
$v version number 

$n default drive 

$q ‘=’ character 

$g ‘>’ character 

$1 ’<’ character 

$b ‘{ character 

$_ a carriage return-line feed sequence 
$s a leading space 

$h a backspace 

$e ASCII code ‘1B’ (escape) 


You can automatically customize your prompt at startup by 
including a PROMPT command in your AUTOEXEC.BAT file. 


If you include the command DEVICE=ANSLSYS in your 
CONFIG.SYS file, then you can use escape sequences in your 
prompts. For example: 


prompt $e[7m$n:$e[m 


sets the prompts in inverse video mode and returns to video 
mode for other text. For more information, refer to 
Appendix G, ANSLSYS. 


EXAMPLES 


The command: 
prompt $p 


sets the drive prompt to the current drive and directory. 
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The command: 
prompt Time = $t$_Date = $d 


sets a two-line prompt which prints: 


Time = (current time) 
Date = (current date) 


The command: 


prompt 
or 


prompt $n$g 


sets the prompt to the current drive and ‘>’ character. 
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RAMDRIVE.SYS 
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RAMDRIVE.SYS is a device driver program that lets you use a 
portion of your computer’s memory as though it were a disk 
drive. RAM disks are much faster than disk drives because they 
operate at the speed of memory. However, any information you 
place in a RAM disk must be copied to a fixed disk or diskette 
before you reboot or turn off power. For more information, see 
Appendix I, RAMDRIVE.SYS. 


Note: Use RAMDRIVE only on machines that have the 
8088/8086 and 80286 processors. On machines that have the 
80386 processor, use VDISK. For more information, see 
Appendix L, VDISK.SYS. 
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PURPOSE 


Recovers a file from a disk containing bad sectors. You can 
also recover all the files on a disk if the directory has been 
damaged. 


Warning: Do not use RECOVER as a substitute for the 
BACKUP and RESTORE commands. When you recover a 
disk with a damaged directory, the filenames, extensions, 
subdirectories, and dates are all lost. 


Note: This command does not work over a network. 


SYNTAX 


To recover a damaged file: 
RECOVER [drive:][path] <filename> 


where: 
drive = drive containing file to be recovered 
path = path containing file to be recovered 
filename = name of file to be recovered 
and: 
<> = required information 
[] — optional information. 


To recover a disk with a damaged directory: 
RECOVER <drive:> 


where: 
drive = disk to be recovered 
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and: 
<> = required information. 


COMMENTS 


When you recover a damaged file, MS-DOS does not recover 
the data in the bad sector. MS-DOS marks the bad sector and 
does not use that sector again. 


RECOVER returns the following message: 
nnnn of nnnn bytes recovered 


The size of the recovered file is always an exact multiple of 
the size of the units that MS-DOS uses to allocate disk space. 
In most cases, this is larger than the actual file size, even 
though the data in the bad sector is not recovered. 


When you recover a file, its filename, extension, subdirectory, 
true size, and date are all lost. The file is renamed 
FILEnnnn.REC. 


If the recovered file is a text file, there may be some unwanted 
characters at the end of it. You will normally have to remove 
these characters before processing the file. You may also have 
to edit the data which occupied the bad sector. 


If the recovered file is an executable file, it is not likely to run 
properly if part of the file was in bad sectors and was lost. 
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RECOVERING DISKS 


When you recover a disk, the filenames, extensions, 
subdirectories, true sizes, and dates are all lost. Each file on 
the disk is given a name of the form: 


filennnn.rec 


where nnnn is a number between 0001 and the maximum 
number of files allowed in the root directory. 


All recovered files are stored in the root directory. The 
number of files in the root and subdirectories may be greater 
than the number of files than MS-DOS allows in the root. If 
so, RECOVER will fill the directory and return the following 
message: 


Warning - directory full 


Examine the files you have recovered and copy the ones you 
want to save to another disk. Then delete any unwanted files 


and type: 


recover <drive:> 


again to recover more files. Continue this procedure until all 
files are recovered. 
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PURPOSE 


Changes the name of a file, but does not copy it to another 
disk or pathname. 


SYNTAX 
REN [drive:][path]<filename1> <filename2> 


where: 
drive = drive containing file to be renamed 
path = path containing file to be renamed 
filenamel = file to be renamed (source) 
filename2 = new filename 


and: 
<> = required information 
[] = optional information. 
SYNONYM 
RENAME 
COMMENTS 


You must supply a drive or pathname if the file resides on 
other than the default drive or current directory. The new 
filename is always created on the same drive and path as the 
source file. REN cannot move files from one drive to another. 


Wild-card characters may be used in either filenamel or 
filename?2. All files matching the first filename are renamed. 
If wild cards appear in the second filename, corresponding 
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character positions will not be changed. For example, the 
command: 


rename *.Ist *.prn 
or 


ren *.Ist *.prn 


changes the extension of all filenames ending in .LST to .PRN. 


The command: 
rename b:chap10 part10 


renames the file CHAP10 on drive B to PART10. 


The file remains on drive B. 
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PURPOSE 


Replaces files in the target directory with files in the source 
directory that have the same name. REPLACE can also add 
files that exist in the source directory (but NOT in the target 
directory) to the target directory. 


SYNTAX 


REPLACE [drive1:][path1] < filename > [drive2:][path2] 
(/A]L/DIL/PI/RIL/SI/ WI] 


where: 
drivel = drive containing source files 
path1 = path containing source files 
filename = source filename (can contain wild cards) 
drive2 = target drive (defaults to current drive) 
path2 = target directory (defaults to current 


directory) 
and: 
<> = required information 
{] = optional information. 
OPTIONS 


The /A option adds new files to the target directory instead of 
replacing existing ones. You may not use this option with 
either the /D or /S options. 


The /D option replaces files in the target directory only if the 
source files are newer than the corresponding target files. 
This option is incompatible with the /A option. 
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The /P option prompts you before replacing a target file or 
adding a source file as follows: 


replace (filename) ? (¥/N) 


The /R option replaces read only files as well as unprotected 
files. If you do not specify this option, any attempt to replace 
a read only file causes an error and stops the replace process. 


The /S option causes REPLACE to search all subdirectories of 
the target directory while it replaces matching files. This 
option is incompatible with the /A option. Replace never 
searches subdirectories in the source path. 


The /W option waits for you to hit any key before replacing 
files. If you do not specify this option, REPLACE begins 
replacing or adding files immediately. 

COMMENTS 


The REPLACE command lets you easily update files on your 
fixed disk with new versions of software. 


As files are replaced or added, REPLACE displays the 
filenames on the screen; then at the conclusion of the replace 
operation, it displays a summary line: 
NNN file(s) added/replaced 
or 


No files added/replaced 
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You cannot use the REPLACE command to update hidden files 


or system files. 


FOR BATCH PROGRAMMERS 


If REPLACE encounters an error, it returns one of the 
following error level codes: 


1 


5 

8 

15 
Other 


EXAMPLES 


Command line error. 
Source file not found. 
Source path not found. 
Access denied. 
Insufficient memory. 
Invalid drive. 

Standard MS-DOS error. 


REPLACING FILES 


Suppose your fixed disk, drive C, contains several files of 
client information with the extension .CLI. To replace these 
files with the latest versions of this file that exist on the disk 
in drive A, you would type: 


replace a:\*.cli c:\ /s 


This command replaces every file on drive C with the 
extension .CLI with the file of the same name from the root 
directory on drive A. 
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ADDING FILES 


Suppose you want to add some new printer device drivers to a 
directory called C:\MSTOOLS, which already contains several 
printer driver files for a word processor. To do this, you 
would type: 


replace a:*.prd c:\mstools /a 


This command adds any files from the default directory of 
drive A with an extension of PRD (that do not currently exist 
in the \MSTOOLS directory on drive C) to C:\MSTOOLS. 
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PURPOSE 


Restores one or more MS-DOS files from one or more 
back-up diskettes to a fixed disk partition. The back-up 
files must have been created using the BACKUP command. 


SYNTAX 


RESTORE <source drive:> <target drive: > 
[path] [/S][/P] 


where: 
source drive = the disk drive to be restored 
target drive = the disk drive to which the backup copy is 
to be restored 


path = path containing file(s) to be restored 
and: 
<> = required information 
{1 = optional information. 
OPTIONS 


The /S option restores all files in all subdirectories, as well 
as those in the specified (or current) directory. This 
includes all subdirectory levels below the specified (or 
current) directory. 


The /P option prompts you before restoring files that are 
read only or files that have been modified since they were 
backed up. Use this option when restoring files backed up 
from MS-DOS Version 2.11 or Version 3.10 disks. 
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COMMENTS 


Once you have entered the RESTORE command, a prompt 
will be issued asking you to insert the backup diskette. If 

you are restoring more than one diskette, be sure to insert 
the diskettes in the right order. The RESTORE command 

will prompt you to insert the next diskette. 


Notes: 


When specifying the path, if you enter only the hard disk 
specifier, then all files backed up from the current 
directory are restored. 


If you specify a path terminating in a directory name, than 
all files backed-up from that directory will be restored to 
it. 


If the path terminates in a file name (or a group of file 
names specified using wild card characters), then only the 
specified file(s) will be restored. 


If you have backed up the root directory of a disk running 
under MS-DOS Version 2.11 or Version 3.10, before you 
restore the root directory, carry out the following 
procedure at the MS-DOS prompt (C:) 


CD\ 

COPY CON IBMIO.COM 

I0.SYS 

Press F6 

Press Enter 

COPY IBMIO.COM IBMDOS.COM 


GTP "BO. Ss 


You have now created two dummy files called 
IBMIO.COM and IBMDOS.COM. These have the same 
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name as the hidden system files used by MS-DOS Version 
2.11 and Version 3.10. When you restore the root 
directory of the c: drive, use the /P option as shown in the 
examples below. 


FOR BATCH PROGRAMMERS 
The exit code is set by the RESTORE command as follows: 


Normal completion. 
The specified file(s) was not found. 


Command execution terminated by user. 


OR oO 


Command execution terminated due to error. 


The exit codes can be used by the batch processing IF 
ERRORLEVEL command. 


EXAMPLES 


The command: 
restore A: C:\ /S /P 


will restore all files on a series of backup diskettes in drive 
A: to the hard disk drive C: in the same directory 
structure. Before restoring a file that was changed after it 
was backed up, RESTORE displays the following: 


filename 

Warning! The file above was changed after it was 
backed up. 

Replace the file (Y/N)? 
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Answer N if filename is IBMBIO.COM, IBMDOS.COM, 
COMMAND.COM, or any other file supplied on your 
MS-DOS Version 3.20 System or Supplementary 
Diskettes. When you restore the files to the hard disk, 
the dummy files IBMIO.COM and IBMDOS.COM can 
be deleted. 


The command: 
restore A: C:*.COM 


will restore to the hard disk drive C: all files on the 
backup diskette(s) with file extension.COM that were 
backed up from the current directory. 


5-138 


THIS PAGE 
INTENTIONALLY LEFT BLANK 


5-139 


MS-DOS Commands 
RMDIR 
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PURPOSE 


Removes a subdirectory from a multilevel directory structure. 


SYNTAX 
RMDIR [drive:] <path> 


where: 
drive = drive containing path to be removed 
path = path to be removed 
and: 
<> = required information 
[] = optional information. 


SYNONYM 
RD 


COMMENTS 


This command removes a directory that is empty except for 

the . and .. shorthand symbols for the current directory and the 
directory that contains it. You must delete all files and 
subdirectories in the directory first. 


Note: You cannot remove a directory that contains hidden 
files, read-only files, or subdirectories. 
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To remove the \USER\JOE directory, (that is, the JOE 
subdirectory in the USER directory), first ensure that the 
directory is empty. Type: 


chmod \user\joe\*.* 


to check if the directory contains any files, including hidden 
file and read-only files. 


If it contains hidden or read-only files, type: 
chmod \user\joe\*.* —rsh 


to remove those attributes. Then copy any files that you wish 
to save to another directory or disk. 


To delete all files, type: 
del \user\joe\*.* 
Then type: 
rmdir \user\joe 


The JOE subdirectory will be deleted from the USER directory. 
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SET 


PURPOSE 


Sets the value of an environment variable to a string for later 
use in programs. 


SYNTAX 
SET [ <variable> = <string> ] 
where: 


variable = a system variable 
string = value to be assigned to variable 


and: 
<> = required information 
{] = optional information. 
COMMENTS 


This command should be used only if you want to set variable 
values in the MS-DOS environment. Environment space may 
be limited if you use memory-resident commands (such as 
MODE, PRINT, and GRAPHICS). For more information, refer 
to the COMMAND command in this chapter. 


If variable already exists in the environment, its string value 
is replaced by the new value. If you type: 


set <variable> = 
then variable is removed from the environment. If you type: 


set 
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MS-DOS displays the current environment variable settings. 
This includes COMSPEC, a variable set by MS-DOS when you 
start MS-DOS, which defines the path where 
COMMAND.COM is stored. The environment will also 
include any PATH and PROMPT commands you may have 
issued, as these commands double as environment variables. 


For more information about using the SET command, refer to 
Chapter 6, Batch Processing Commands. 


EXAMPLE 


The command: 
set tagdir = c: \tagged 


sets your TAGDIR variable to the value c:\TAGGED until you 
change it with another SET command. 
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PURPOSE 


Enables programs in a network to share files. 


SYNTAX 
SHARE [</F: space>][< L:locks>] 


where: [] = optional information. 


OPTIONS 


The /F:space allocates file space (in bytes) for the area MS-DOS 
uses to record file-sharing information. Each file that is 

open needs the length of the full filename plus 11 bytes (the 
average pathname is 20 bytes). The default value for the /F 
option is 2,048 bytes. 


The /L:locks option allocates the number of locks you want to 
allow. Each lock allows one user or application to access the 
shared file. The default value for the /L option is 20 locks. 


COMMENTS 


The SHARE command is only used when networking is active. 
It is included in the AUTOEXEC.BAT file to install shared 
files. 


Once you have used the SHARE command in an MS-DOS 
session, all read and write requests are checked by MS-DOS. 
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The following example loads file sharing and uses the default 
values for the /F and /L options: 


share 


For more information, refer to the STARLAN NETWORK AT&T 
Personal Computer 6300 User's and DOS Server Guide. 
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PURPOSE 


Positions the heads on a fixed disk for shipment. 


SYNTAX 
SHIP 


Note: After you enter the SHIP command, turn off the 
system immediately, since using the fixed disk moves the 
heads out of the shipping position. 


COMMENTS 


You can use the SHIP command with up to two fixed disks. 
Use it when you move the system more than a few feet. SHIP 
will not move the head on a third fixed disk or external disk 
connected to your system. See Appendix H, DRIVER.SYS, for 
information about external disks. 


Note: If you have two fixed disks, SHIP identifies them as 
drives C and D, no matter what letters MS-DOS has 
assigned to your fixed disk partitions. 
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PURPOSE 


Lists the filenames and file sizes of specified files, as well as 
the total number of specified files and the sum of the file sizes. 
Can also be used to determine the space required to contain 
the specified files on a different drive. 


SYNTAX 
SIZE [drive1:][path][filename] [drive2:] 


where: 
drivel = drive containing file to be listed 
path = path containing file to be listed 
filename = file to be listed (can contain wild cards) 
drive2 = target drive 
and: 
[] = optional information. 


COMMENTS 


Using SIZE with no arguments lists the files in your current 
directory. To list files in other directories, both a path and 
filename are required. Wild-card characters (? and *) are 
permitted in the filename. 


If a second drive is specified, SIZE determines how much 
space on this drive would be consumed by each specified file 
if it were copied to the drive. This is useful if you want to 
copy files from one drive to another and are not sure if they 
will fit on the target drive. The amount of space required for 
each file is determined by the actual size of the file and the 
cluster size of the specified drive. Since disk space is allocated 
in terms of whole clusters (the disk space represented by a 
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cluster cannot be divided between multiple files), the space 
consumed by a file will generally be more than the actual file 
size. 


If a diskette drive is specified as the second drive, a diskette 
must be installed in the drive when SIZE is run. 


EXAMPLES 


The command: 
size *.com 


will list all files with the .COM extension in the current 
directory. The output would look like the following: 


chkdsk. com 6400 
diskcopy.com 2576 
format.com 2534 


3 files, total of 11510 bytes. 
The command: 
size c:\mydir\subdir\*.* 


will list all files in the directory \mydir\subdir on drive C. 


The command: 


size c:\txtdir\*.txt a: 
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will list the *.txt files in the directory \TEXTDIR on drive C, 
and will also indicate the space that these files would consume 
if they were copied to the diskette in drive A. The output 
would look like the following (assuming a cluster size of 1,024 


bytes for drive A): 


copy.txt 2466 
ctty.txt 1625 
xecover.txt 2213 
comp.txt 2519 
personal.txt 2574 
sort.txt 617 


3072 
2048 
3072 
3072 
3072 
1024 


6 files, total of 12014 bytes, 


space required on A: 


(15360) 


bytes disk 


If you want to list the files in another directory, you also must 
enter a filename. The filename can be *.*. Entering: 


size a:\path 


without a filename causes SIZE to return the number of files 


and sizes as zero. 
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SORT 


PURPOSE 


An MS-DOS filter that reads standard input, sorts the data 
alphabetically, then writes it to your computer screen, a file, or 
to another device. 


SYNTAX 
SORT [/R][/+n] 


where: [] = optional information. 


OPTIONS 


The /R option reverse the sort; that is, sorts from Z to A. 


The /+n option sorts starting with column n where n is some 
number. If you do not specify this option, SORT will begin 
sorting from column 1. 


COMMENTS 


SORT cannot sort files larger then 63 Kb. SORT can be used 
to alphabetize a file by a certain column. Characters are sorted 
according to their ASCII values, except that lower-case letters 
are treated as upper-case letters. Characters with binary values 
above 127 are sorted by their binary values. (Appendix J, 
ASCII Character Values, contains the ASCII values for each 
character inn your computer's character set.) 


Numbers are sorted according to character value, not numeric 
value. For example, SORT might sort a list of numbers as: 1, 
10, 11, 2, 3, 37,4... 
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EXAMPLES 


The command: 
sort /r < unsort.txt > sort.txt 


reads the file UNSORT.TXT, reverses the sort, and then writes 
the output toa file named SORT.TXT 


Notes: 


The angle brackets in this example are redirection 
symbols. You must type them exactly as shown with 
spaces around them for the SORT command to work. 


The left angle bracket (<) means "get the input from" a 
file. If the left angle bracket and filename are missing, 
SORT will sort standard input (usually what you type on 
the keyboard). After you’ve typed the SORT command, 
type the text you want to sort, pressing RETURN at the end 
of each line. At the end of the list, press CTRL-Z followed 
by RETURN. 


The right angle bracket (>) means "send the output to"a 
file. If the right angle bracket and filename are missing, 
SORT will display the sorted file on standard output 
(usually the display screen). 


The command 
dir | sort /+14 


pipes the output of the directory command to the SORT filter. 
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The SORT filter sorts the directory listing starting with 
column 14 (this is the column in the directory listing that 
contains the file size), then sends the output to the screen. The 
result of this command is a directory sorted by file size. 


The command: 
dir | sort /+14 | more 


will do the same thing as the command in the previous 
example, except that the MORE filter gives you a chance to 
read the sorted directory one screen at a time. 


For more information about pipes, redirection, and standard 
input and output, refer to the Directing the Results of 
Commands section at the beginning of this chapter. 
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SUBST (SUBSTitute) 


PURPOSE 


Substitutes a one-letter alias for a pathname. 


Notes: This command does not work over a network. Do 
not use SUBST with the following commands: ASSIGN, 
BACKUP, DISKCOMP, DISKCOPY, FORMAT, JOIN, 
LABEL, and RESTORE. 


SYNTAX 
SUBST [drive1:] [drive2:][path] [/D] 

where: 
drivel = one-letter drive alias 


drive2 = drive containing path to be given an alias 
path = path to be given an alias 


0 


and: 


optional information. 


OPTION 


The /D option deletes an associated drive or pathname. 


COMMENTS 


SUBST creates or deletes a "virtual drive" by associating a 
pathname with a drive letter. Because applications written for 
MS-DOS Version 1 do not recognize pathnames, you may need 
to substitute a "virtual drive" for a pathname before running 
them. 
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When MS-DOS sees a drive that was created with the SUBST 
command, it replaces the reference with the new pathname. 
The specified pathname should be complete; that is, it should 
start from the root directory. 


MS-DOS does not allow a drive letter greater than E unless 
the CONFIG.SYS file read at start-up contains a LASTDRIVE 


command. Refer to Appendix E, CONFIG.SYS, for more 
information. 


EXAMPLES 
If you type: 


subst 


MS-DOS displays the names of the "virtual drives" in effect. 


The command: 
subst z: b:\usr\fred\form 


creates a virtual drive Z for the pathname 
B:\USR\FRED\FORM. Now, instead of typing the full 
pathname, you can get to this directory by simply typing z: in 
a command. 


The command: 


subst z: /d 
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deletes a substitution. The files still exist in the subdirectory, 
but the virtual drive Z no longer exists. 


Also refer to the JOIN command description earlier in this 
chapter. 
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SYS (SYStem copy) 
ee eee eee 


PURPOSE 


Copies the MS-DOS system files to the specified disk drive 
from the default drive. 


Notes: 
This command does not work over a network. 


You cannot use SYS to copy system files to a DOS data 
partition on a fixed disk. 


SYNTAX 
SYS <drive:> 


where: 
drive = drive that will receive system files 
and: 
<> = required information. 


COMMENTS 


SYS is normally used to update the system or to place the 
system on a formatted diskette that contains no files. You must 
type a drive letter with this command. 


The target diskette must be completely blank or already have 
the system files IBMBIO.COM and IBMDOS.COM. 
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The transferred files are copied in the following order: 


IBMBIO.COM 
IBMDOS.COM 


IBMBIO.COM and IBMDOS.COM are both hidden files that do 
not appear when you type the DIR command. 
COMMAND.COM (the command processor) is not transferred. 
Use the COPY command to transfer COMMAND.COM. 


In some cases when the target disk contains a very old version 
of MS-DOS, the copy will fail because there is inadequate 
room for the system files. In these cases, use the FORMAT /S 
command to place a current version of the system files on a 
new disk, then copy all data and program files over to the new 
disk. 
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TAG 


PURPOSE 


Specifies a set of files for subsequent use with the EXEC 
command, which executes a specified MS-DOS command once 
for each file in the set of tagged files. Tagging a file copies its 
drive identifier, path, and filename to a text file called the tag 
file. 


TAG and its companion commands EXEC and UNTAG let a 
single MS-DOS command operate on multiple files without 
restrictions on filenames, regardless of which directories 
contain the files. 


For more information refer to the EXEC and UNTAG 
command descriptions in this chapter. 


SYNTAX 
TAG [[[drive:][path] <filename> ].... [/S]] 


where: 
drive = drive containing file to be tagged 
path = path containing file to be tagged 
filename = name of file to be tagged 
and: 
<> = required information 
[] = optional information. 


Note: Multiple paths may be specified in a single TAG 
command; however, each path specified must be 
accompanied by a filename. Wild cards are permitted in 
filenames. If no path is specified, the current directory is 
assumed. 
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OPTIONS 


The /S (Subdirectory) option tags files matching the filename 
specification in all subdirectories including, and beneath, the 
specified path or paths. If no path is specified, /S tags all the 
specified files in the current directory and all of its 
subdirectories. You must specify at least one filename when 
using the /S option. That is, the command: 


tag /s 
is not valid. 


COMMENTS 


Tagging a set of files is most useful when they are located in 
multiple directories or their filenames are unrelated and you 
plan to execute several subsequent MS-DOS commands on that 
set of files. This happens often in batch files used to execute a 
sequence of MS-DOS commands. 


Tagging a file copies its drive identifier, path, and filename to 
a text file called TAG$$.DAT or the "tag file". The tag file will 
automatically be placed in one of two directories: 


¢ The directory containing the TAG.EXE file (you should 
include the name of this directory in the environment 
variable PATH). 


° A directory specified with the TAGDIR environment 
variable. 


The PATH and TAGDIR environment variables can be set in 
the AUTOEXEC.BAT file, any other batch program, or at the 
MS-DOS prompt. 
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You cannot tag system files or hidden files. 
TAG displays the name of each file as it is tagged. 


If you attempt to tag a file that is already tagged, TAG will 
display: 


<filename> already tagged 


and attempt to tag the next specified file (if any). 


If you type: 


tag 


TAG displays the names of all the currently tagged files. 


Once you tag a file, it remains tagged until you untag it using 
the UNTAG command. Deleting a file or turning off the 
computer does not untag a file. (You can also untag a file by 
removing its name from the tag file, using any editor that 
edits ASCII text files.) 


FOR BATCH PROGRAMMERS 
The TAG, EXEC, and UNTAG commands may be used inside 


or outside of batch programs. For example, you can type: 


exec myprog $$ 
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to execute the MYPROG.BAT batch program, once for each 
tagged file. The MYPROG.BAT file can, in turn, contain TAG, 
EXEC, and UNTAG commands. 


Note: In the program itself, you may explicitly reference 
each tagged file by using the %1 parameter. 


No matter where the TAG and UNTAG commands appear, 
they can alter the current contents of the tag file. Thus, for 
example, you could tag a number of files and then run a batch 
program which tags more files, references all the tagged files 
with an EXEC command, untags some or all of the tagged files, 
and then references the new set of tagged files with another 
EXEC command. 


The following example does just that: it untags all currently 
tagged files, tags two files and then executes a batch program 
that tags all files in the current directory with the .LTR 
extension, copies all the tagged files into a single file called 
TODAYS.WRK, untags files with the .LTR extension and the 
name TODO, and then displays the names of all files that are 
still tagged. 


You'd type the following commands: 
untag 


tag stafmemo.714 todo.715 
joinwork 
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where JOINWORK.BAT contains these MS-DOS commands: 


tag *.ltr 

exec type $$ >> todays.wrk 
untag *.ltr todo.* 

tag 


The last TAG command displays the names of all the currently 
tagged files; in this example, it displays only the filename 
STAFMEMO.714. 


When a batch file containing TAG, EXEC, or UNTAG 
commands is EXECed, it is executed once for each filename 
that exists in the tag file when MS-DOS first reads the EXEC 
statement. Tagging or untagging files within the batch 
program does not affect the number of times the batch 
program itself is executed. 


For example, if you type the commands: 


untag 
tag stafmemo.714 todo.715 
exec joinwork 


the program JOINWORK.BAT is executed twice, once for 
STAFMEMO.714 and once for TODO.715, even though 
TODO.715 is untagged within the batch file and remains 
untagged after execution is complete. 


Note: The string $$ is not required to run 
JOINWORK.BAT. 
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For more information about using TAG, UNTAG, and EXEC in 
batch programs, refer to the FOR command description in 
Chapter 6, Batch Processing Commands. 


EXAMPLES 


The command: 
tag c:\bin\*.com \wp\jim\*.ltr bob.txt 


tags all the following files: 
* All files in the BIN directory of drive C with the 
extension .COM 


° All files in the JIM subdirectory of the WP directory of 
the default drive with the extension .LTR 


* The file BOB.TXT in the current directory. 
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TIME 


PURPOSE 


Displays and sets the time. 


SYNTAX 
TIME [hh[:mm{[:ss[.cc]]]] 


where: 

hours (00-23) 

minutes (00-59) 

seconds (00-59) 

hundredths of seconds (00-99) 


col 


and: 


optional information. 


COMMENTS 
If you just type: 


time 
the following message is displayed: 


Current time is hhimm:ss.cc 
Enter new time:_ 


Press RETURN if you do not want to change the time shown. 
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If you want to change the time after you have started 
MS-DOS, (for example, to set 8:20 a.m.), type: 


time 8:20 


at the MS-DOS prompt. The new time must be entered using 
numbers only; letters are not allowed 


Times are entered on a 24-hour clock; hh is 00 between 
midnight and 12:59 a.m. and between 13 and 23 from 1 p.m. 
and midnight. 

If you type hours only, minutes are set to 00. 


If you do not type a valid time, MS-DOS displays the message: 


Invalid time 
Enter new time:_ 


MS-DOS then waits for you to type a valid time. 


EXAMPLE 
To set the time to 2:45 p.m., type: 


time 14:45 


and press RETURN. 
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TREE 


PURPOSE 


Displays directories and files, and optionally deletes files 
throughout the entire tree directory structure. 


SYNTAX 


TREE [drive:][path\][filename] [/A][/D][/Q] 


where: 
drive = drive whose directory structure is to be 
displayed 
path = path whose directory structure is to be 
displayed 
filename = file(s) to be listed or deleted 
and: 
[] = optional information. 
OPTIONS 


The /A option causes TREE to list only files that have the A, 
or Archive, attribute set. Whenever you modify a file in any 
way, MS-DOS sets the A attribute to mark it as "changed." 
Programs such as BACKUP use this in determining what files 
need to be backed up. 


You can determine what files you have changed in any way 
on your disk by typing (from the root): 


tree *.* /a 


the /D option causes TREE to delete each file it finds. A 
typical use for this is for deleting all .BAK files from fixed disk 
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with many subdirectories, where it would be tedious to enter 
each directory and do it manually. 


The /Q option works only with the /D option. It causes TREE 
to list each file and ask: 


delete? (y/n) 


before actually deleting the file. This is helpful if you aren’t 
sure you want to delete all of them. /Q is necessary if you 
enter *.* as the filename; this prevents TREE from accidentally 
deleting all the files on your disk. 


COMMENTS 


TREE is used to display files and subdirectory structure. The 
display starts with the current or specified directory and 
displays all subdirectories down through the tree directory 
structure. Directories are displayed in upper-case letters. 
Filenames are displayed in lower-case letters. Subdirectories 
and files are indented under the directory that contains them. 


If you specify a path without a filename, you must add a 
backslash (\) after the pathname. TREE then displays only the 
names of the subdirectories contained in the specified 
directory. 


If you specify a filename, TREE displays the names of all 
subdirectories contained in the current or specified directory, 
as well as all filenames matching the specification. 


You can also specify disk drives in the usual manner. The 
command TREE D: will list all the directories on drive D on 
and under the current or specified directory on drive D. 
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To pause the screen output, press CTRL-S or pipe the output 
to the MORE filter. 


EXAMPLES 


The following examples will use the this directory structure of 
a disk called SYSTEM: 


\ (root directory) 


COMMAND. COM 
AUTOEXEC. BAT 


\pos \BASIC \BIN 
DEBUG .COM BASICA.COM EDITOR.COM 
SY¥S.COM LETTER. TXT 
MEMO. TXT 
\BASIC\PROGS 
SINE. BAS 


The command: 


tree 
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entered with no parameters from the root directory would 


display: 


pos 

BIN 

BASIC 
PROGS 


The command: 
tree 


entered from the \BIN subdirectory displays no subdirectory 
names since TREE works from the current directory down to 
the lowest level it finds. It never looks "up" or "sideways" on 
the tree to see the \(root), \PROGS, \BASIC, or \DOS 
subdirectories. 


The command: 
tree *.* 


entered from the root directory displays: 
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command.com 
autoexec.bat 
2 files, nnn bytes 
Dos 
debug.com 
sys.com 
2 files, nnn bytes 
BIN 
editor.com 
letter.txt 
memo.txt 
3 files, nnn bytes 
BASIC 
basica.con 
1 file, nnn bytes 
PROGS 
sine.bas 
1 file, nnn bytes 


The command: 


tree *.txt 


entered from the root directory displays: 


DOS 
0 files, 0 bytes 
BIN 
letter.txt 
memo.txt 
2 files, 1024 bytes. 
BASIC 
0 £iles, 0 bytes 
PROGS 
0 files, 0 bytes 
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The following is an example of using TREE to delete files. If 
you have a file DATE.BAS in several subdirectories on your 
disk, entering the following will delete them with the 
optional question: 


tree date.bas /d/q 


Dos 
BIN 

date.bas delete? (y,n) deleted 
BASIC 

date.bas delete? (y,n) deleted 


2 files, 512 bytes. 
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TYPE 


PURPOSE 


Displays the contents of a file on the screen. Use this 
command to view a file without modifying it. 


SYNTAX 
TYPE [drive:][path] <filename> 


where: 
drive = drive containing text file to be displayed 
path = path containing text file to be displayed 
filename = text file to be displayed 
and: 


<> = required information 
[] = optional information. 


COMMENTS 


Displaying a binary file (for example, any file with the 
extension .COM, .EXE, or .BIN) is not recommended. This 
results in control characters and escape sequences being sent 
to your display screen, which can produce unwanted side 
effects. If you have displayed a binary file and the prompt at 
the bottom of the screen is unreadable or unconventionally 
displayed, press the RESET button at the base of your 
computer to restore the display. 


Note that when you use TYPE to display a file with tabs in it, 
all tabs are expanded to 8 spaces wide. 
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Use the MORE command with a TYPE command to view one 
screen at a time, for example: 


type bigfile |more 
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UNTAG 


PURPOSE 


Removes filenames from the tag file, a set of filenames created 
with the TAG command. For more information, refer to the 
TAG and EXEC commands earlier in this chapter. 


SYNTAX 
UNTAG [[[drive:][path] <filename>] ... [/S]] 


where: 
drive = drive containing file to be untagged 
path = path containing file to be untagged 
filename = name of file to be untagged. 
and: 


<> = required information 
[] = optional information. 


Note: Multiple paths may be specified in a single UNTAG 
command; however, each path specified must be 
accompanied by a filename. Wild cards are permitted in 
filenames. If no path is specified, the current directory is 
assumed. 


OPTIONS 


The /S (Subdirectory) option untags all tagged files matching 
the file specification in all subdirectories including, and 
beneath, the specified path or paths. If a filename is specified 
without a path, /S untags all tagged files matching the file 
specification in the current directory and all of its 
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subdirectories. You must specify at least one filename when 
using the /S option. That is, the command: 


untag /s 


is not valid. 


COMMENTS 


Once you tag a file, it remains tagged until you untag it using 
the UNTAG command. Deleting a file or turning off the 
computer does not untag a file, because the filename remains 
in the tag file TAG$$.DAT. (You can also untag a file by 
removing its filename from the tag file, using any editor that 
edits ASCII text files.) TAG$$.DAT ceases to exist only when 
all currently tagged files are untagged. 


UNTAG displays the name of each file as it is untagged. 


If you type: 
untag 


UNTAG displays the message: 


All tagged files in the tag list will be untaggea 
Press ENTER to continue or CTRL-BREAK to exit 


Press RETURN to untag all the currently tagged files. 
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If you attempt to untag a file that is not tagged, UNTAG will 
display: 


<filename> not tagged 
and attempt to untag the next specified file (if any). 


EXAMPLES 


The command: 
untag c:\bin\*.com 


untags all previously tagged files in the BIN directory of drive 
C with the extension .COM. 
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VDISK.SYS 


LEE mn’ 


VDISK.SYS is a device driver that enables a virtual 
disk drive with the next available drive letter. For 
more information, see Appendix L, VDISK.SYS. 
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VER (VERsion) 


PURPOSE 
Displays MS-DOS version number. 


SYNTAX 


VER 


COMMENTS 


If you want to know what version of MS-DOS you are using, 
type: 


ver 


The version number will be displayed on your screen. 
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VERIFY 
ee 


PURPOSE 


Turns the VERIFY option on or off for use when writing to 
disk. The VERIFY option verifies that your files are correctly 
written. 


Note: The VERIFY command does not verify data written 
over a network. 


SYNTAX 
VERIFY [{ON) {OFF} ] 


where: 
[] = optional information 
{} = either/or. 


Note: Do not abbreviate this command; VER is a different 
command. 


COMMENTS 


This command has the same purpose as the /V option in the 
COPY command. If you want to check that all your files are 
written correctly to disk, you can use the VERIFY command to 
tell MS-DOS to confirm that your files are intact (no bad 
sectors, for example). MS-DOS will automatically verify each 
time you write data to a disk. You will receive an error 
message only if MS-DOS was unable to successfully write your 
data to disk. 


VERIFY OFF is the default setting. 
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VERIFY ON remains in effect until you change it in a program 
(by a Set Verify system call), or until you type: 


verify off 


If you want to know what the current setting of VERIFY is, 
type: 


verify 


with no options. 
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VOL (VOLume) 
Se 
PURPOSE 

Displays disk volume label, if it exists. 
SYNTAX 
VOL [drive:] 
where: 
drive = drive containing volume label 


and: 
[] = optional information. 


COMMENTS 


This command displays the volume label of a fixed disk drive 
or the diskette in a specific drive. If you do not type a drive 
letter, MS-DOS prints the volume label of the default drive. 
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XCOPY 


PURPOSE 


Copies files and directories, including lower-level directories if 
they exist. Because XCOPY can copy directory structures from 
one type of disk to another, it is more versatile than COPY. 


SYNTAX 


XCOPY [drive1:][path1][filename1] [drive2:][path2][filename2] 
VAJ/E]U MY[/PI/S][/ V][/W][/D:<mm-dd-yy>] 


where: 
drivel = drive containing source file 
path = path containing source file 
filenamel = name of source file 
drive2 = drive containing target file 
path2 — path containing target file 
filename2 = name of target file 
mm = month 
dd = day 
VY Sealy 
and: 
<> = required information 
[] = optional information. 


You must include at least one of the source parameters. 
Note: If you omit the target parameters, XCOPY assumes 
you want to copy the files to the default directory without 


changing the name. 


If you do not specify the path option, XCOPY uses the default 
directory. The default filename is *.*. 
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OPTIONS 


The /A option copies source files that have their archive 
attribute set. Whenever you modify a file in any way, 
MS-DOS sets this attribute to mark it as "changed." /A does 
not modify the archive bit of the source file. Refer to the 


CHMOD command for information on how to set the archive 
attribute 


The /D option copies source files that you modified on or after 
the date specified by mm-dd-yy. 


The /E option copies any subdirectories, even if they are 
empty. You can use this option only with the /S option. 


The /M option is similar to the /A option since it copies 
archived files only; however, it also turns off the archive 
attribute in the source file. Refer to the CHMOD command in 
this chapter for information on setting the archive attribute. 


The /P option prompts you with: 
(Y/N?) 


allowing you to confirm whether you want to create each 
target file. 


The /S option copies directories and lower-level subdirectories 
unless they are empty. If you omit this option, XCOPY works 
within a single directory. 


The /V option causes XCOPY to verify each file as it is written 
to the target to make sure that the target files are identical to 
the source files. This option may slow down XCOPY. 
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The /W option causes XCOPY to wait before it starts copying 
files. XCOPY displays the message: 


Press any key when ready to start copying files 


You must press a key to continue, or press CTRL-BREAK to 
abort the XCOPY command. 


COMMENTS 


One use of XCOPY is to copy the contents of a diskette to 
another type of diskette with a different format. You cannot 
use the DISKCOPY command to copy from one disk format to 
another, because its track-by-track copying method requires 
the source and target diskettes to save the same format. The 
COPY command can copy files from one diskette format to 
another, but COPY cannot copy directory structures. 


So, if you want to make a copy of a disk that contains files in 


subdirectories to a target disk with a different format, you 
must use the XCOPY command. For example: 


xcopy a: b: /s /e 


copies all of the files and subdirectories (including any empty 
subdirectories) on the disk in drive A to the disk in drive B. 


Note: The XCOPY command may prompt you to specify 
whether the target is a file or a directory. 
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XCOPY uses the following rules for copying files: 


* If the source is a directory, the target is a directory. 


¢ If the source includes multiple files, the target is a 
directory. 


° If you append a backslash (\) to the end of the target 
name, the target is a directory. For example: 


xcopy payroll a:\workers\ 


FOR BATCH PROGRAMMERS 
If XCOPY encounters an error, it returns one of the following 
error level codes: 
0 Copy without error 
1 No files found to copy 
2 CTRL-C entered by user to terminate XCOPY 
4 


Initialization error. There is not enough memory— 
invalid drive or command line syntax, file not found, 
or path not found. 


5 INT 24 error occurred. The user aborted from INT 24 
error reading or writing disk. 
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Batch Processing 
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Introduction 


Batch processing is having your computer perform a job froma 
series of commands without interruption. This is the opposite of 
interactive processing (which you have been doing all along) where 
you type a command to the computer and get a response back 
before typing the next command. The word "batch" comes from 
the time when people in data processing entered programs in 
"patches" of punched cards. Your computer reads files on a disk 
instead of punched cards, but it still has batch processing 
capability. 


Why Use a Batch File? 


In your daily work, you may find yourself typing the same 
sequence of commands time and again to perform some 
frequently used tasks. To avoid having to do this, you can create 
a file containing a series of such commands that are immediately 
performed one after another. This is a batch file, and you can 
execute the entire sequence of commands by typing just the name 
of the batch file. The commands are executed as if they had been 
typed individually at the keyboard. 


You might, for example, place the CD (change directory) and DIR 
(directory) commands in a batch file to avoid having to type these 
commands each time you want to display certain files in a 
subdirectory. For example, a batch file called DIRMEM.BAT 
containing the commands: 


cd letters 
dir mem*.ltr 
cd \ 
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would display memo files similar to the following when you type 
the batch filename at the system prompt. When you type: 


dirmem 


the display, for example, would be similar to: 


A> cd letters 
A> dir mems.1tr 


Volume in drive A has no label 
Directory of A:\ 


MEMA LTR 32 07-09-86 10:35a 
MEMB LTR 57 07-10-86 9:15a 
MEMC LTR 22 07-11-86 9:30a 
MEMD LTR 26 07-12-86 10:01a 
A> cd \ 

A> 


The first two lines of the display are the MS-DOS commands in 
the batch file. MS-DOS displays these commands as they are 
executed unless instructed not to do so. The next few lines are 
the same display you would get if you had typed the command 
yourself, while the last line is the last MS-DOS command in the 
batch file. 
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The MS-DOS and ABL 
Batch Processors 


The AT&T MS-DOS Version 3.2 supports all of the existing MS- 
DOS batch processor commands. It also adds a set of batch 
commands used by the new Advanced Batch Language (ABL) 
batch processor, a command language that is compatible with 
other versions of MS-DOS and that adds several new and unique 
features. 


The MS-DOS Batch Processor 
The MS-DOS batch processor uses internal batch commands 
usually available when you load MS-DOS. They include: 

+ ECHO 

+ FOR 

+ GOTO 

- IF 

+ PAUSE 

+ REM 

+ SHIFT 


Each of these commands is described on the command reference 
pages at the end of this chapter. 


Naming the MS-DOS Batch File 


When you create a batch file containing the MS-DOS batch 
commands, in addition to any MS-DOS commands described in 
Chapter 5, name the file using the .BAT extension. For example: 


mybatch.bat 
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Executing the MS-DOS Batch File 


After you have created the MS-DOS batch file, you execute it by 
typing the file name without its extension at the system prompt. 
For example: 


mybatch 
Stopping the Execution of the MS-DOS Batch File 
To stop the execution of the MS-DOS batch file, press 


CTRL-BREAK. The command being executed in the batch file 
ends, and the following prompt is displayed: 


Terminate batch job (Y/N)? 
Type: 
y 


to terminate the batch file. The remaining commands in the 
batch file are ignored and the MS-DOS prompt is displayed. 


Type: 


to continue executing the remaining commands. 
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The ABL Processor 


The ABL processor uses external batch commands and recognizes 
all of the batch processor commands (listed previously) in earlier 
versions of MS-DOS. The program ABL.EXE must be available to 
your computer. 


The ABL batch commands include: 


+ DO UNTIL 

+ GETLINE 

+ IF-THEN-ELIF-ELSE-ENDIF 
+ SETINT 

+ SETSTR 

+ WHILE 


Each of these commands is described on the command reference 
pages at the end of this chapter. 


Naming the ABL Batch File 

When you create an ABL batch file (a batch file with any ABL 
batch command), name the file using an ATT extension. For 
example: 


mybatch.att 


This will help you later when you want to remember which batch 
files have MS-DOS batch commands (the BAT extension) and 
which have ABL batch commands, since the commands for 
executing the two types of batch files are different. 
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Executing the ABL Batch File 


You execute an ABL batch file by typing ABL at the system 
Prompt, an optional pathname, and the filename. The syntax of 
the command is: 


ABL [pathname]<filename>.ATT 


You do not need to type the filename extension. For an ABL 
batch file named MYBATCH.ATT, for example, you type: 


A> ABL mybatch 


The pathname variable is optional. If you do not precede the 
filename with a full pathname, ABL searches your current 
directory and then the global PATH variable to locate the file. If 
you type a full pathname, however, ABL does not search the 
PATH variable, and the file must be located in the path you type. 
When the file is not found, ABL stops its search, generates an 
error code 4 ("terminated due to an error"), and displays the 
message: 


<filename> not found 


where <filename> represents the name of your file. 


Stopping the Execution of the ABL Batch File 


To stop the execution of the ABL batch file, press CTRL-BREAK, 
just as you do for the MS-DOS batch file. The command being 
executed in the batch file ends, and the program terminates. 
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Creating a Batch File 
A batch file is a text file, with a BAT or ATT filename extension, 


that holds MS-DOS or ABL batch commands, respectively. You 
create a batch file the same way you create a regular text file. 


+ Use a word processor or text editor that creates files in 
standard ASCII (American Standard Code for Information 
Interchange) codes. 


+ Use EDLIN provided on your MS-DOS System Diskette. 
+ Use the COPY command from the keyboard or console 
(useful only for short batch files). 


Follow these steps to create a batch file using the COPY 
command. 


1 At the MS-DOS prompt type: 
copy con <filename>.bat or <filename>.att 


(Substitute the name you want for your batch file for 
filename.) 


2 Press RETURN. 


3. Type the commands you want to include in the 
batch file. Press RETURN after you type each 
command. 


Note: If you make a mistake typing a command, 
use the BACKSPACE key to correct it. If you 
realize you made an error on a line after you 
have pressed RETURN, you cannot go back and 
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correct it. You will have to press CTRL-BREAK. 
This ends the COPY command without saving 
the batch file. You must then repeat the 
procedure; therefore, use COPY mainly for short 
batch files. 


4 Press F6 and then RETURN when you have finished 
typing commands. This ends the COPY command 
and saves the batch file. 


This message is displayed: 
1 File(s) copied 


The AUTOEXEC.BAT File 


The AUTOEXEC.BAT file is a special batch file you can use to 
perform your own start-up procedure each time you start or 
restart ("reboot") your computer. Its name means "automatically 
execute a batch" of commands. The file contains MS-DOS 
commands you would otherwise enter each time you turn on or 
restart your computer. You create the file on your working copy 
of the MS-DOS System Diskette or on your fixed disk. 


Every time you start MS-DOS, it looks for the AUTOEXEC.BAT 
file in the root directory on the disk that MS-DOS was started 
from. 


For example, you can create an AUTOEXEC.BAT file that sets the 
MS-DOS PATH variable by including the PATH command in the 
file. 
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You can also execute an ABL batch file from the AUTOEXEC.BAT 
file by making the last command in it the ABL command. In the 
AUTOEXEC.BAT file, you put: 


ABL [pathname]<filename>.ATT 


Although [pathname] is optional, you should include it when 
using the ABL command inside the AUTOEXEC.BAT file. 


Using a Batch File with Replaceable Parameters 


Within a batch file you can include dummy parameters (or 
“arguments') that can be replaced by values you supply following 
the batch filename on the batch file command line. 


For example, if the batch file EXAMPLE.BAT contains these 
commands: 


copy %1 %2 
type %2 
type %0 


the parameters %1 and %2 are replaced sequentially by the 
arguments you supply on the batch file command line when you 
execute the file. The parameter %0 is always replaced by the 
drive specifier, if given, and the filename of the batch file. In the 
AUTOEXEC.BAT file, %0 is not set to any value. 


Notes: 


Up to 10 dummy parameters (%0 - %9) can be specified within 
a batch file. More than 10 arguments can be specified on the 
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batch file command line (see the discussion of the SHIFT 
command in this chapter). 


If you want to use % as part of a filename within a batch file, 
you must specify it twice. For example, to specify the file 
ABC%.EXE you must type it as ABC%%.EXE in the batch file. 
In this way, the special meaning that % has as described 
above is removed. Otherwise, when MS-DOS replaces 
parameters, it would discard %.., changing the filename in the 
batch file to ABCEXE. 


To execute the EXAMPLE.BAT file and pass arguments, type the 
batch filename followed by the arguments you want sequentially 
substituted for %1, %2, etc. 


For example, you can type: 
example a:prog1.mac b:prog2.mac 


example is substituted for %0, a:prog1.mac for %1, and 
b:prog2.mac for %2. 


The result is the same as if you typed each of the three commands 
(in the EXAMPLE.BAT file) from the keyboard with their 
arguments, as follows: 


A> copy a:prog1.mac b:prog2.mac 
A> type b:prog2.mac 
A> type example.bat 
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Command Variables, Statements, and 
Conditional Expressions 


MS-DOS batch commands allow you to use limited types of 
variables and conditional expressions for repeatedly executing a set of 
statements. These include: 


+ Global variables that exist from the time they are set, 
either before or while the batch file is executed, until you 
turn off or restart your system. 


+ Conditional expressions that compare two text strings and 
check error codes, in the context of the IF statement. 


ABL adds several new features that give you a more powerful and 
versatile batch processor for the MS-DOS environment. ABL 
features include: 


+ Conditional statements (FOR, IF-THEN-ELIF-ELSE-ENDIF, 
WHILE, and DO UNTIL) to give batch processing the logic 
of a programming language. 

Compound statements grouped together with the {} 


characters and treated syntactically as single commands in 
ABL batch files. 


A GETLINE command allowing you to type input into an 
executing ABL batch file. 


The ability to call other batch or ABL batch files from an 
ABL batch file and return control to the calling file at the 
command following the calling command. 


Local variables whose names do not require special 
characters such as %, although this character is allowed, 
and that exist only during the execution of the ABL batch 
file. 


+ Syntax allowing commands to span lines. 
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Variables 


A variable is a place holder whose value can change. It is a means 
of providing data to a batch program. You can supply the values 
to variables through a variable definition statement in the body of 
the batch file or on the batch file command line, or input the 
value for a variable from the keyboard while the batch file is 
being processed. ABL supports all of the MS-DOS batch 
processor variables from previous versions of MS-DOS. 


MS-DOS Batch Processor Variables 
MS-DOS batch processor variables include: 


+ Global variables 
+ Variables defined in the FOR command 


+ Batch file command line arguments. 


MS-DOS Global Variables. MS-DOS global variables are defined 
as %variable% and are established by the SET command. Its 
syntax is: 


SET [<variable>=<string>] 


Global variables belong to the MS-DOS command processor 
environment. When a batch program sets global variables, they 
become a permanent part of the operating system environment, 
and are erased only by redefining the variable name as nothing 
(using the command SET name= either in the batch program or 
at the MS-DOS prompt) or by turning your computer off and back 
on (rebooting). 
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In MS-DOS, there are three global variables that usually exist: 
COMSPEC, PATH, and PROMPT. COMSPEC always exists, that 
is, its value cannot be changed. PATH and PROMPT (also 
commands) exist in the environment only if you set them; you 
can change the values of PATH and PROMPT. For an 
explanation of the characteristics of these as global variables, refer 
to the COMMAND, PATH, PROMPT, and SET command 
descriptions in Chapter 5. 


Some applications programs create and assign values to their own 
global variables using the SET command in the format: 


SET [<variable-name=string >] 


The application program usually appends such SET commands to 
the AUTOEXEC.BAT file when you install the program on your 
computer. Because AUTOEXEC.BAT executes each time you start 
or restart your computer, the variables will always be available 
whenever you load the program into memory. If the program 
cannot find an AUTOEXEC.BAT file, it creates one. 


MS-DOS Variables in the FOR Command. You can define 
variables in the FOR command as %%variable. For example: 


for %%f in (file1 file2 file3 file4) do copy a:%%f b: 


They exist only for the duration of the command and only for the 
statement used in the command. 


MS-DOS Command Line Arguments. You can supply arguments 
on the batch file command line. The command line arguments 
are represented by the %0 through %9 parameters in the batch file 
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and exist only during execution of the batch file. The values of 
these parameters and their arguments can be modified by the 
SHIFT batch command. (See the section Using a Batch File With 
Replaceable Parameters earlier in this chapter for additional 
information.) 


ABL Processor Variables 


ABL supports all of the MS-DOS batch processor variables. It 
supports global variables to the extent their value is changed only 
as long as the ABL batch file is being processed. Upon 
completion of the batch program, global variables return to their 
original value. ABL also adds a fourth variable type: 


+ A string or integer variable used only in the ABL batch 
file. As such, the variable is a local one, that is, "local" to 
the batch file. 


Local character string variables are defined using the SETSTR 
command. Local integer variables are defined using the SETINT 
command. Both SETSTR and SETINT are used in the ABL batch 
file only and cannot be used at the system prompt. The syntax 
for local string definition is: 


SETSTR <variable> = <string> 
The syntax for local integer definition is: 
SETINT <variable> = <arithmetic expression> 


Local variable names cannot have the same names as existing 
global variables because errors would occur. The reason is these 
variables are stored differently. Global variables remain in the 
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operating system environment after batch processing is completed 
and may also exist before batch processing is started. In either 
case, global variables may be erased by the batch program using 
the SET command to redefine the variable as nothing. Local 
variables, however, exist in the ABL batch file and only during 
the execution of the batch program. 


ABL local variables must begin with an alphabetic character and 
can be followed by upper or lower case letters, digits, 
underscores, or periods. No other characters are acceptable for 
naming local variables. 


All global variables must be enclosed in percent signs (%) if they 
contain characters not allowed in ABL local variables. For 
example: 


set %#_of_times%=0 


If a global variable contains no characters that are not allowed in 
a local variable, it does not need to be enclosed in %s. 


A global variable in a REM or ECHO command, or label 
statement, or in a string expression, must be enclosed in %s to 
replace the variable names with the value when displayed. 


The length of a variable name is restricted only insofar as its 
variable definition statement must be on one line. 


Note: Integer variables given values (either by a SETINT 
assignment statement or arithmetic operation) greater than 
32,767 or less than -32,767 will produce unpredictable results. 
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Statements 


A statement is some type of meaningful expression or general 
instruction. ABL supports all of the various types of MS-DOS 
batch processor statements from previous versions of MS-DOS, 
and adds more functionality through new features such as 
assignment statements and compound statements. 


MS-DOS Batch Processor Statements 
Statements used by the MS-DOS batch processor include: 


+ Any MS-DOS command 


+ Programs in executable files with a COM or .EXE 
extension 


+ Any MS-DOS batch command (listed in the The MS-DOS 
Batch Processor section earlier in this chapter) 


+ Labels that can be used as targets for the GOTO command 
(see the discussion of the GOTO command in this chapter). 


Note: This label statement is not the LABEL command 
described in Chapter 5. 


ABL Processor Statements 


Statements used by ABL include: 


+ Any MS-DOS batch processor statements 


+ Commands that execute other MS-DOS or ABL batch files 
with a BAT or ATT extension, respectively 


+ Any ABL batch commands listed in The ABL Processor 
section earlier in this chapter 
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+ Assignment statements 


+ Compound statements consisting of any combination of 
the above. 


ABL Assignment Statements. ABL allows assignment statements 
on local variables you define in your ABL batch file with the SET, 
SETSTR, or SETINT commands (SET is described earlier in the 
section MS-DOS Global Variables, and SETSTR and SETINT are 
described earlier in the section ABL Processor Variables.) The 
syntax of an assignment statement is: 


SETINT <variable> = <arithmetic expression> 


or 
SETSTR <variable> = <string> 
Two examples: 


setint count = 0 
setint count = count + 1 


setstr myname —John A. Doe 


Note that every character after the equal sign in a statement is set 
to the variable defined; for example John A. Doe is set to the 
variable defined as myname. As a result, quotation marks are not 
used as delimiters in assignment statements that define string 
variables. If you include quotation marks, they are treated as part 
of the string. 
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ABL Compound Statements. Compound statements are a group 
of individual statements executed as a unit, and can replace any 
single statement shown as part of the syntax for a command. You 
form a compound statement by enclosing multiple statements in 
left and right braces ({}). The left brace signals the start of the 
compound statement and the right brace signals the end. 


For readability, the left brace should be specified on a line by 
itself preceding the compound statement; the right brace should 
be specified on a line by itself succeeding the compound 
statement; and the statements that make up the compound 
statement should be indented. 


You can use a compound statement wherever a single statement is 
required. In the following example, the program sets the value of 
the variable count equal to 10 and counts down from 10 to 0, 
displaying the numbers 10 through 1 in a column on the screen. 


setint count=10 
echo off 
while count >0 


rf 


echo %count% 
setint count = count - 1 


endwhile 
echo on 


In this example, the statements that make up the compound 
statement are: 


echo %count% 
setint count = count - 1 
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The statement on the first line displays the value of the variable 
count. The statement on the second line changes the value of 
count (by subtracting 1 from count each time the statement is 
executed). Without the ability to make compound statements, you 
only would be able to have one statement for those commands 
that require a statement as part of their syntax. 


Conditional Expressions 


A conditional expression is a statement that is either true or false. If 
the condition is true, the statement following the condition is 
executed. If the condition is false, the statement following the 
condition is bypassed. Conditional expressions, then, are used to 
branch among statements and commands in a batch file. 


The conditional expressions used in previous versions of MS-DOS 
are supported by ABL. ABL also allows you to use conditional 
expressions containing relational operators and arithmetic 
operators, as well as "compound" conditional expressions where 
boolean operators are placed between any two conditional 
expressions. 


The IF command is a good example of a command that uses 
conditional expressions. For example, in the MS-DOS batch 
processor IF command: 


IF <condition> <statement> 


the condition argument is replaced by the conditional expression 
that is evaluated as true or false. If the condition is true, then the 
command in the statement argument is executed. 
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For example: 


if exist myfile print myfile 
[command] 


If myfile exists, the condition is true, and myfile is printed. If 
myfile does not exist, the condition is false, and the command 
will not be executed. The command on the next line is 
performed. 


MS-DOS Batch Processor Conditional Expressions 


In the MS-DOS batch processor, a conditional expression is one of 
the following, all of which are used in the IF command: 


<string1> == <string2> 
ERRORLEVEL <number> 
EXIST <filename> 
NOT <condition> 


+ <string1>==<string2> is true if each character in 
string1 matches the character in the corresponding 
position in string2. 


+ ERRORLEVEL is true if the exit code of the last MS-DOS 
command executed matches the argument given to 
ERRORLEVEL. Common exit codes are: 


0 =successful completion 
1 = file(s) not found 
2 = (not used) 
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3 = terminated by user 


4 = terminated due to an error 


Other exit codes are given with the MS-DOS commands 
(Chapter 5) that set them. These commands include 
BACKUP, DISKCOMP, DISKCOPY, FORMAT, REPLACE, 
RESTORE, and XCOPY. 


+ EXIST checks for the existence of the named file. 


+ NOT inverts any conditional expression. For example, in 
the IF command: 


IF NOT <condition> <statement> 


the NOT qualifies the statement so that statement executes 
only if condition is not true. 


An example of their use is as follows: 


backup c:\utilit a: 
if error level 1 echo No files were found to back up 


These conditional expressions may also be used in ABL’s 
enhanced IF command and new WHILE and DO UNTIL 
commands as explained on their command reference pages at 
the end of this chapter. As an example, the following 
program gets the first filename argument on the batch file 
command line and prints the contents of that file. It then 
repeats the process once for each of the remaining filename 
arguments on the batch file command line: 
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do 

{ 

shift 
ecier %1 


until not errorlevel 0 


where uprint is a user command to print a file and has the 
capability to set ERRORLEVEL to a value other than zero if it 
finds no filename given to it. 


ABL Processor Conditional Expressions 


The ABL processor supports the MS-DOS string comparisons and 
the ERRORLEVEL, EXIST, and NOT functions. It also adds more 
flexibility in conditional expressions through its use of: 


+ Relational operators including the boolean "and" and "or" 
used to form "compound" conditional expressions 


+ Arithmetic operators. 


ABL Relational Operators. The ABL relational operators are: 


> Greater than 

< Less than 

= Equal to 

<> Not equal to 

>a Greater than or equal to 
<= Less than or equal to 

& boolean "and" 

+f boolean "or" 
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The syntax for relational operators in conditional expressions is: 
<expression1> <relational operator> <expression2> 


When the boolean & ("and") is used between two conditional 
expressions, both conditions must be true for the entire statement 
to be true. When the boolean + ("or") is used between two 
conditional expressions, either one or both conditions need to be 
true for the entire statement to be true. 


The boolean operators only can be used between complete 
conditional expressions, that is, strings or arithmetic expressions 
may not be evaluated together ("and"ed together or "or"ed with 
each other). Each of these complete conditional expressions, 
when joined together by a boolean operator must be enclosed in 
parentheses. In this way, you can form "compound" conditional 
expressions. 


For example, the following shows acceptable use of the boolean 


or": 
if (name==larry) + (name==jim) then... 
You cannot use: 


if name==larry + jim then... 


because it joins ("or" ed) together the strings larry and jim with 
no relational operator between them, which is not a complete 
conditional expression. 
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The following example shows the use of relational operators in a 
program: 


setint count=1 

setint digit=0 

sinput 

echo Enter the number of files you want copied, up to five 
getline digit 

: (digit <1) + (digit >5) then 


echo invalid entry 
goto input 


elif (digit >=1) & (digit <=5) 
{ 
while count <=digit 


copy a:%1 b: 
shift 
setint count=countt+1 


endwhile 


) 


endif 


This program copies between one and five files from drive A to 
drive B. Note the use of the boolean operators (+ representing 
“or" and & representing "and") between the conditional 
expressions in the IF and ELIF statements (IF and ELIF are 
explained later; see the command reference page for the ABL IF 
command). The boolean operators here determine whether an 
acceptable number of files have been requested for copying. 
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ABL Arithmetic Operators. As mentioned earlier, ABL allows | 
you to define local integers (SETINT). This permits arithmetic 

expressions containing five of the common arithmetic operators 

and the unary minus. In order of precedence, the arithmetic 

operators are: 


- unary minus 
(evaluated left to right) 


+) multiplication and division 
(evaluated left to right) 


+- addition and subtraction 
(evaluated left to right) 


Precedence means how the operators are evaluated. In an 
arithmetic expression containing multiple arithmetic operators, all 
the unary minus operators are evaluated first, then multiplication 
and division, and finally addition and subtraction. You can alter 
precedence and evaluation order by using parentheses to define 
which parts of an arithmetic expression should be evaluated first. 
For example, in: 


(a+b)*x 


the addition is done first before the multiplication. Without the 
parentheses, the default precedence would occur, that is, 
multiplication before addition. You can also use multiple sets of 
parentheses where the innermost set of parentheses is evaluated 
first. 
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Evaluating left to right means that in an arithmetic expression 
containing more than one particular type of arithmetic operator, 
the leftmost operator is evaluated first, followed by the same 
remaining ones. In an arithmetic expression with more than one 
unary minus, for example, the leftmost unary minus is evaluated 
first, followed by the remaining unary minus operators from left 
to right in the expression. 


You can use arithmetic expressions with relational operators 
(described previously). The syntax for arithmetic expressions and 
relational operators in conditional expressions is: 


<arithmetic expression> <relational operator> <arithmetic expression> 


The following is an example of conditional expressions using 
arithmetic operators. Note that SETINT is used to define and give 
an initial value of zero to the integer variable "i". 


: define i and give it an initial value of 0 
setint i= 0 
while i <= 22 
( 
if (i / 2) * 2 == i then echo %i% 
else echo odd number 
endif 
setint imit1 
} 


endwhile 


In this example, the program displays even numbers. While i is 
less than or equal to 22, i is first divided by 2 and then multiplied 
by 2. If the result is equal to i, then the number will be even and 
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will be displayed; otherwise, the number will be odd, and ECHO 
will display: 


odd number 


For example, if i = 9, then 9 + 2 = 4.5. The batch program 
truncates the decimal, leaving 4. 4 x 2 = 8, one less than 9. Asa 
result, (i / 2) * 2 does not equal i (8 does not equal 9) and "odd 
number" is displayed. 


Note: Integer variables given values (either by a SETINT 
assignment statement or arithmetic operation) greater than 
32,767 or less than -32,767 will produce unpredictable results. 
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This section presents a sample batch file program that can be 
processed by either the MS-DOS batch processor or the ABL 
Processor. Commands are shown as they appear in the batch file. 
The result of executing the batch program is also shown. 


Sample Batch Program 
The batch file shows an example usage of the following BATCH 
commands in conjunction with some MS-DOS commands: 

+ ECHO 

+ FOR 

+ GOTO 

+ IF 

+ PAUSE 

+ REM 

+ SHIFT 


In this file (ADMIN.BAT), BATCH commands are shown in upper 
case, while all other commands are shown in lower case. To 
facilitate explanation, line numbers are shown in this example. 
These should not be typed into a BATCH program. 


The remainder of this section is a line-by-line description of the 
sample program. A brief description of the program’s intent is 
given within the program (lines 3 through 31). Where 
explanations would be repetitive, they are omitted (for example, 
Line 48). 
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ADMIN.BAT 


1 ECHO off 
2cls 


4.REM Sample BATCH processor program 


PROGRAM NAME: ADMIN 
8 ECHO ‘User Administration Program 
9 ECHO * 

10 ECHO ‘This program enables the system administrator to add users to 

11 ECHO “a file containing a list of users (user.dat) and create user 

12 ECHO ‘profiles for the new users (name.usr). 

13 ECHO * 

14 ECHO ‘The number of users that can be added at one time is limited 

15 ECHO “only to the number of names that can be typed as arguments to the 

16 ECHO *program name (ADMIN). The last new user’s name MUST be followed 
17 ECHO “by the word END, which is a signal to the program that no more 

18 ECHO *names are to follow. For example, 

19 ECHO * 

20 ECHO * ADMIN Sue Bob Perry end 

21 ECHO *is a valid entry. 

22 ECHO * 

23 ECHO *The new list of users is sorted and displayed for the administrator. 

24 ECHO * 

25 ECHO *The program then checks to see if the new user has a user 

26 ECHO *profile. If not, a new one is created from the default 

27 ECHO “user profile. The new list of user profiles is displayed 

28 ECHO “for the administrator. (A new user might already have a user 

29 ECHO “profile. An example is the case of a user who is temporarily 

30 ECHO “inactive.) 

31 ECHO esse 
32 ECHO *ADMIN halts until you are ready. To resume, 
33 PAUSE 

34 IF not exist default.usr ECHO user > user.dat 

35 IF exist user.dat ECHO * 
36 IF exist user.dat ECHO *Old list of use 
37 IF exist user.dat type user.dat 

38 IF exist user.dat ECHO 
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39 :begin 

40 ECHO *New User: %1 

41 IF exist user.dat GOTO oldlist 

42 ECHO %1 > user.dat 

43 GOTO chkprofile 

44 :oldlist 

45 ECHO %1 >> user.dat 

46 :chkprofile 

47 IF not exist %o1-usr copy default-usr %1.usr 
48 REM Get next new user. 
49 SHIFT 

50 IF %1 == end GOTO finish 

51 GOTO begin 


52 REM No more users. 
53 :finish 

54 REM Sort list of users. 
55 sort < usr.dat > usr.dat 

56 ECHO °* 


57 ECHO *Updated list of users: 
58 type user.dat 

59 ECHO ++ 
60 ECHO *Updated list of user profiles: 
61 FOR %%£ IN (*.usr) DO ECHO %%f 
62 ECHO +++ 
63 REM End of program. 
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Explanation 


Line 1 - ECHO off 
This use of the ECHO statement prevents each batch 
command from being echoed to the screen. 


Line 2 - cls 
MS-DOS command to clear the screen. 


Lines 3 through 7 - REM 
REM commands are comments. 


Lines 8 through 32 - ECHO 
This use of the ECHO command prints text at the screen. 
These lines of the program explain the programs intent to its 
user. 


Line 33 - PAUSE 
The PAUSE statement causes execution of the batch program 
to halt until you resume it. The PAUSE command is used 
here to give you a chance to read the text printed on the 
screen before the program continues. You can resume 
execution with any keystroke. 


Lines 34 through 38 - IF 
The IF statement enables you to execute certain statements 
only when a condition is satisfied. In line 34, if the 
default.usr file does not exist already, the program creates one 
with the word "user" as its contents. In lines 35 through 38, 
the same condition is applied: the existence of the USER.DAT 
file. If the USER.DAT file exists, then a salutation is printed 
on the screen, followed by a listing of the contents of the 
USER.DAT file. The contents are listed through the use of 
the MS-DOS TYPE command. 
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Line 39 - :begin 
The label statement, where the label is the first word on the 
line (for example, begin). A number of other labels can be 
found in this program. In this batch program, the labels 
begin, oldlist, chkprofile, and finish are used as objects of 
GOTO statements. 


Line 40 - ECHO 
Using the ECHO statement and an argument, display the 
name of the current new user. This name was entered as an 
argument on the command line with the batch program name 
ADMIN. For example, to add a user named Sue to the old list 
of users, type at the MS-DOS prompt: 


admin Sue end 


Line 41 - IF 
This IF statement, like the statements in lines 34 through 38, 
checks for the existence of the file USER.DAT. If the file 
exists, the program jumps to the label statement at line 44 
(oldlist). If the file, USER.DAT, does not exist, then a new 
one is created by the ECHO statement at line 42. 


Line 42 - ECHO 
This ECHO statement places the current new user's name into 
a brand new file called USER.DAT. The use of the single 
character ">" opens this file and then ECHO prints the new 
user’s name in it. This statement is executed only if the IF 
statement at line 41 is not true. 
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Line 43 - GOTO 
This GOTO statement causes the batch program to 
unconditionally jump to the statement labeled "chkprofile” 
(line 46). This statement is executed only if the IF statement 
at line 41 is not true. 


Line 44 - :oldlist 
Label statement. 


Line 45 - ECHO 
This ECHO statement, executed only if the IF statement at 
line 41 was true, places a new user in the USER.DAT file. 
The double characters "> >" cause ECHO to append the new 
user’s name to the old list of users. 


Line 46 - :chkprofile 
Label statement. 


Line 47 - IF 
This IF statement checks for the existence of a file. The prefix 
of the file’s name is the name of the new user. This is done 
by using the %1 where the filename prefix would otherwise 
be present. The extension of this file is USR. For example, if 
the new user’s name is Bob, then this IF statement checks for 
the existence of a file named: BOB.USR. The use of NOT 
before EXIST causes the MS-DOS COPY command to be 
executed only if the desired file (for example, BOB.USR) is not 
found. This program assumes that the file DEFAULT.USR 
already exists. 


6-36 


Batch Processing Commands 


eee 


Line 49 - SHIFT 
The SHIFT command moves the next argument typed with 


the batch filename ADMIN into the first position. For 
example, had the user typed: 


admin Tom Joe end 


initially, the first argument would be "Tom," the second 
argument would be "Joe," and the third argument would be 
"end." Note that the name of the command (in this example, 
ADMIN) is never shifted. The first execution of the SHIFT 
command moves each argument one place "to the left." In 
other words, "Joe" becomes the first argument, while "end" is 
now the second argument. The argument "Tom" is now lost. 


Line 50 - IF 
This IF statement checks to see if the current first argument is 
equal to "end." If it is, then there are no more users and the 
GOTO statement causes the program to jump to the statement 
labeled "finish" (line 53). 


Line 51 - GOTO 
This GOTO statement causes execution of the program to 
jump to the statement labeled "begin" (line 39). This 
statement is only executed if the IF statement at line 50 was 
not true (that is, the current argument was not equal to 
“end"). 


Line 53 - :finish 
Label statement. 
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The MS-DOS command, SORT, sorts the items in the file 
USER.DAT into alphabetical order. The redirection symbols 
("<"and ">") enable USER.DAT to be both the input and the 
output of the SORT command. 


Lines 56 and 57 - ECHO 
These ECHO statements print a header for the following 
MS-DOS TYPE command. 


Line 58 - type 
The MS-DOS command, TYPE, lists the contents of the 
updated USER.DAT file. 


Lines 59 and 60 - ECHO 
These ECHO statements print a header for the following 
batch FOR command. 


Line 61 - FOR 
This use of the batch command FOR allows repetitive 
execution of the ECHO command. The effect is to print the 
name of each file in the current directory with the extension 
-USR. 
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Result 


Assuming the file DEFAULT.USR exists but USER.DAT does not, 
typing: 


admin Sue Bob Perry end 


at the MS-DOS prompt would result in the following display, 
excluding the CLEAR SCREEN (cls) and ECHO OFF commands: 


*User Administration Program 
"This program enables the system administrator to add users to 
*a file containing a list of users (user.dat) and create user 
*profiles for the new users (name.usr). 


"The number of users that can be added at one time is limited 

“only to the number of names that can be typed as arguments to the 
*program name (ADMIN). The last new user’s name MUST be followed 
*by the word END, which is a signal to the program that no more 
*names are to follow. For example, 


fi ADMIN Sue Bob Perry end 
*is a valid entry. 


*The new list of users is sorted and displayed for the administrator. 


*The program then checks to see if the new user has a user 
“profile. If not, a new one is created from the default 

‘user profile. The new list of user profiles is displayed 

*for the administrator. (A new user might already have a user 
*profile. An example is the case of a user who is temporarily 
*inactive.) 

*ADMIN halts until you are ready. To resume, 
Strike a key when ready ... 


*New User:SUE 
1 File(s) copied 
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*New User:BOB 
1 File(s) copied 
*New User:PERRY 
1 File(s) copied 


*Updated 
BOB 
PERRY 


*Updated list of user profiles: 
DEFAULT.USR 

SUEUSR 

BOB.USR 

PERRY.USR 


6-40 


Batch Processing Commands 


Command Syntax 


ee 


In order for your computer to understand batch commands, you 
must enter them in an exact form, called command syntax. This 
section contains a few simple rules for interpreting the syntax 
line given with each command on the following command 
reference pages. 


+ Any words in capital letters must be entered exactly as 
shown. You can make these entries in upper-case letters, 
lower-case letters, or a mixture of both. 


Anything enclosed in paired angle brackets ( < > ) is 
required information. You supply the text. For example, 
when you see <filename> on the syntax line, you type in 
the name of your file. Don’t type in the paired angle 
brackets themselves; this would cause a problem. 


Anything in square brackets ([ ]) is optional information 
that may change the function of a command. For example, 
when you see [comment] on the syntax line, you type in a 
comment if you want it displayed. Make sure you enter 
all the information necessary to use the options you want 
to use. Again, don’t type in the square brackets 
themselves; this would cause a problem. 


Anything in braces ( {} ) indicates that you must make a 
choice among two or more entries. You must enter one 
and only one. If all choices are enclosed in surrounding 
square brackets, you do not have to enter any of them. 
The syntax line ECHO [ {ON} {OFF} {<comment>}] 
indicates that you can type echo, echo on, echo off or echo 
comment. Again, don’t type in the braces themselves; this 
would cause a problem. 


6-41 


Batch Processing Commands 


Note: In many of the examples, braces enclose groups 
of command lines. These braces are needed for the 
program and are not the same as the braces used on 
the syntax line. 


+ Spaces are important. You should include a single space 
in the command line: 


— After the command name 
— After each specified filename 
— After device names or other required text strings 


— Between filenames and options. 


However, you should not include spaces: 
— Within filenames or pathnames 


— Between drive letters, pathnames, and filenames. 
Complete file specifications should omit spaces. For 
instance: 


b:\wp\alice\myplans.ltr 


should contain no space. 


The syntax lines for some commands enclose brackets in 
other brackets. For example, the syntax line 

SET [<variable>=<string>] indicates that you can type 
set or set followed by a variable, an equal sign, and a 
character string. 
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+ When you see other punctuation marks (commas, equal 


signs, question marks, colons, semicolons, and slashes), 


enter them exactly as shown. These punctuation marks are 
essential. 


If there is not enough room on the display screen for your 
command to fit on one line, just keep typing. Your 
command will automatically continue on a new line. Press 
RETURN only when you are finished typing. 
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DO UNTIL 


PURPOSE 


Allows repeated execution of a statement until a specified 
condition is met. 


SYNTAX 
DO <statement> UNTIL <condition> 


where: 
statement = an executable statement or command 
condition = an expression to be evaluated 
and: 
<> = required information. 


COMMENTS 


DO UNTIL executes the associated statement first before 
evaluating the condition. Therefore, the body (statement) 
of the do-until loop will always execute at least once 
regardless of whether the condition is true or false. DO 
UNTIL is the opposite of the WHILE command in that 
WHILE evaluates a condition first before it executes a 
statement. You can replace any statement with a 
compound statement by enclosing multiple statements in 
braces ({}). Refer to the earlier section Conditional 
Expressions in this chapter for an explanation of 
conditional expressions. 
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EXAMPLE 


setint count=10 
echo off 
do 
{ 
echo %count% 
} setint count — count - 1 
until count == 0 
echo on 


When this program is executed, the following is displayed: 


S 


anvauanroos 


This example shows how DO UNTIL is used in an ABL 
batch file. This program repeatedly displays the current 
count until the condition "count equals zero" is met. The 
current count is reduced by 1 (by count -1) each time the 
DO UNTIL loop executes. 
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ECHO 


PURPOSE 


Allows you to choose whether to have the commands in 
your batch file displayed on your screen as each command 
is performed. It also allows you to display a comment on 
the screen, as well as the value of a variable, provided the 
variable name is enclosed in % signs. 


SYNTAX 
ECHO [{ON) {OFF} {<comment>}] 


where: 
comment = text to be displayed on your screen 
and: 
<> = required information 
[] = optional information 
Q} = either/or. 


COMMENTS 


Commands in a batch file are normally displayed on the 
screen as they are executed by your computer. ECHO is 
ON after you turn power on or do a system reset. ECHO 
ON displays all the commands and the results of those 
commands as they are executed. ECHO OFF stops the 
display of commands on the screen and displays command 
results only. If you enter just ECHO, the current ECHO 
state (ON or OFF) is displayed. If you enter ECHO anda 
comment, the comment text is displayed on the screen. 
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The comment argument can be a variable that you must 
begin and end with a percent sign (%) to have its real 
value substituted and displayed. ABL differentiates 
between ECHO with no arguments and ECHO with a 
variable that evaluates to a null string (a string with no 
characters, not even blanks). A null results in a new line 
being generated. 


EXAMPLE 


echo off 
set name=John D. Doe 
echo %name% 


When this program is executed, the following is displayed: 
John D. Doe 


This program uses ECHO to display the value (defined by 
SET) of the variable name. ECHO OFF prevents the 
commands themselves from being displayed. 
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FOR 


PURPOSE 


Causes repetitive execution of the statement for each 
element of the set. 


SYNTAX 
Batch processing: 
FOR %%<variable> IN <set> DO <statement> 
Interactive processing: 
FOR %<variable> IN <set> DO <statement> 
where: 
variable = any character except 0-9 


set = a list of items separated by a space and 
enclosed in parentheses 


statement — an expression, executable program, or 
MS-DOS command to be executed 
and: 
<> = required information. 


COMMENTS 


In batch processing, the variable parameter can be any 
character except the numbers 0 through 9 and must be 
preceded by two percent signs (%%); this avoids confusion 
with the %0 through %9 batch parameters used with batch 
file command line arguments. In interactive processing 
(that is, you enter the FOR command at the MS-DOS 
prompt instead of placing it in a batch file), variable need 
only be preceded by one percent sign. The variable exists 
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only for the duration of the FOR loop. set is a list of items 
separated by spaces and enclosed in parentheses. For 
example: 


(filel file2 file3 file4) 


is a set. The variable is sequentially assigned the value of 
each member of set, and then the statement after DO is 
executed for every member of the set. You can replace 
any statement with a compound statement by enclosing 
multiple statements in braces ({}). 


If a member of set is an expression involving the wild- 
card characters * or ?, or both, then the variable is set to 
each matching filename in the current directory. In this 
case, however, only one member of the set can have a 
wild-card character. Any other item with a wild-card 
character is ignored. Valid set members include filenames, 
pathnames (kept relatively short), arguments %1 through 
%9, and character or integer constants (a b c or 1 2 3). 


You cannot nest FOR commands in MS-DOS like a FOR- 


NEXT command is used in GWBASIC. If you try to do 
this, the message: 


FOR cannot be nested 


appears when you are running your batch program. The 
program will not perform as you expected. 


Batch Processing Commands 
FOR 
(MS-DOS and ABL) 


In ABL, however, you can nest FOR commands as shown 
in the fourth example. 


SETS AND TAGGED FILES 


As mentioned in Chapter 5, AT&T’s MS-DOS adds new 
TAG, UNTAG, and EXEC commands. These commands 
allow files to be grouped together, or ungrouped, to let a 
single command operate on all the "tagged" files. The ABL 
command processor includes the function TAGSET() that 
expands to the list of files previously tagged by the TAG 
command. This function is only used with the FOR 
command in a list of items that make up a set. The 
TAGSET() function can be mixed with lists of explicit set 
members and set members with wildcards. 


The TAGSET() function expands the list of set members as 
the FOR loop progresses through them. If the TAG file is 
changed, by means of the TAG and UNTAG commands 
inside the loop, it has no effect on the previously 
expanded set. This does not mean that the files inside the 
loop are not tagged, just that the set is not expanded to 
include them; such tagged files are added to the tag file 
TAGME.TAG. If the contents of the new TAG file are 
desired, TAGSET() can appear more than once in the set 
list. The fifth and sixth examples show how TAGSET can 
be used. 
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EXAMPLE 1 
for %%f in (file1 file2 file3 file4) do copy a:%%f b: 


In this example, the copy statement will be repeated for 
each of the names in the set, with each name (file1 file2 
file3 and file4) assigned in turn to the variable %%f. The 
effect of this FOR command is the same as if you used four 
separate COPY commands to copy the files from drive A to 
drive B: 


copy a:file1 b: 
copy a:file2 b: 
copy a:file3 b: 
copy a:file4 b: 


EXAMPLE 2 


for %%i in (a.doc b.doc a.asm b.asm) do 
{ 

echo %%i Queued for printing 

print %%i 


echo Done with abl file 


This example, like the first, uses an explicit list of 
filenames (a.doc b.doc a.asm and b.asm) as the set. 
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The variable %%i is sequentially assigned each file. The 
files are queued for printing and printed. As each file is 
queued, the comment Queued for printing is displayed. 
When the ABL program finishes executing, the comment 
Done with abl file is displayed. 


EXAMPLE 3 


for %%£ in (*.bak) do del %%f 


This FOR command deletes each file with a .bak extension 
in the current directory. The example shows the use of 
the wildcard character * in the set. The %% is needed so 
that after batch parameter (%0-%9) processing is complete, 
a % remains. If only %f was entered, the batch parameter 
processor sees the first %, looks at f, decides that %f is a 
bad parameter reference, and discards the %f. The FOR 
command would never receive this parameter. In a batch 
file, you must use the expression %%. 


If you are in interactive processing mode, only one % is 
needed, since you are not executing a batch file with the 
FOR command in it. 
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EXAMPLE 4 


rem Each subdirectory supplied as an argument to this batch file 
rem May contain files but not other subdirectories. 

rem The full path name must be specified for each subdirectory. 
on ‘%%i in (%1 %2 %3) do 


cd %%i 

for %%j in (*.*) do del %%j 
cd \ 

rmdir %%i 


This example program shows how ABL FOR loops can be 
nested. The program performs four functions for each 
subdirectory you specify as an argument on the batch file 
command line. It changes to that subdirectory, deletes the 
files there, changes to the root directory, and removes the 
subdirectories. 


EXAMPLE 5 


tag *.prn 
for %%i in (tagset()) do 
i 

print %%i 


In this example, the first line of the program tags all files 
ending in prn. The files, for example, are 1.prn, 2.prn and 
3.prn. TAGSET() then expands the set to include these 
tagged files as the set members. The PRINT command 
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prints each file. TAGSET() functions as if you had 
included the files as an explicit list in the set, as in: 


for %%i in (1.prn 2.prn 3.prn) do 


EXAMPLE 6 


for %%i in (*.asm) do 
( 
tag %%i 
netprint %%i 
: netprint is a user program to spool to the network 


for %%i in (tagset()) do 
{ 
echo %%i 
if exist %%i then masm %%i 
:MASM is an assembler program 
else 
{ 
: Flag files specified in the set but 
: not found by the exists command. 
echo File not found 
goto loop end 


endif 
: exit on errors 
if not errorlevel 0 then 
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{ 
echo error in masm ABL file aborted 
goto finish 


endif 
sloop_end 


:finish 


In this example, the program performs two functions: (1) 
it tags and prints program files and (2) assembles these 
files. The program begins execution by tagging all the 
program files ending in asm and then queuing (or 
"spooling") them for printing. 


In the second FOR loop, the program uses TAGSET() to 
expand the set members to include all these tagged files. 
ECHO displays each full filename. The program checks to 
see if the file exists and, if it does, calls masm, an 
assembler program used to assemble the program file. If a 
file is not found, ECHO displays: 


File not found 


and goto loop_end causes the program to jump to the end 
of the loop, where execution of the next iteration follows. 
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When the ERRORLEVEL is a value other than 0, ECHO 
displays: 


error in masm ABL file aborted 


and goto finish causes the program to exit the loop. 


Note: For ABL to function properly with TAGSET, ABL 
must be run in either a directory containing TAG.EXE or a 
directory specified with the TAGDIR environment 
variable (see the TAG command description in Chapter 5). 
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GETLINE 


PURPOSE 


Allows an ABL batch file to accept your input from the 
keyboard during program execution. When the ABL 
command processor encounters GETLINE, it suspends 
program execution and continues processing when you 
type a line ended by a carriage return. 


SYNTAX 


GETLINE <variable> 


where: 
variable = global or local string or local integer 
and: 
<> = required information. 
COMMENTS 


The variable for GETLINE can be a global string, local 
string, or local integer type, and must be defined by SET, 
SETSTR, or SETINT prior to its use in the GETLINE 
command. (Refer to the section Variables earlier in this 
chapter for an explanation of these variable types). Also, 
only correct input is accepted. Strings cannot exceed 80 
characters. Local integers cannot have a decimal point. 
Your input, when the variable is defined as a local integer 
(SETINT), can only be a string of digits. If you type 
incorrect input, the variable in the GETLINE command is 
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not assigned the value you typed in, and the following 
error message is displayed: 


Invalid input to GETLINE 
Please try again 


You are prompted to retry your input only once. If you 
type incorrect input again, a fatal error occurs indicated by 
the message: 


Invalid input to GETLINE 
FATAL ERROR 


Execution of batch processing will then stop. 


EXAMPLE 


setint number=0 

echo please enter a number from 1 thru 5 
:enter_number 

getline number 

if number < 1 then 


echo number below proper range 
echo please try again 
goto enter number 

} 


elif number > 5 
echo number above proper range 
echo please try again 
goto enter_number 


endif 


In this example program, when the getline statement is 
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executed, you can input a number 1 through 5. The 
number you type is placed in the variable number which 
is then verified to ensure that correct data was received. 
Also, note how the label statement :enter_number marks a 
position in the program. It becomes a target the goto 
command uses, that is, goto enter_number. 
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GOTO 


PURPOSE 


Directs a batch program to jump to a specified label and 
execute the command on the line that immediately follows 
that label. 


SYNTAX 
GOTO <label> 


where: 
label = the label name 
and: 
<> = required information. 


COMMENTS 


A label, when it appears on a line by itself in the batch 
file, is specified as a colon (:) followed by a character string 
interpreted as a label name. Embedded blanks are not 
allowed in the label name; instead, the underscore is used 
to separate words for readability. In addition, the label 
may be followed by a blank space and an optional 
comment. In the GOTO command, the label name is 
specified without its preceding colon, and must refer to a 
label defined elsewhere in the batch program. 
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If label is not defined, the current batch file stops 
Processing and the message: 


Label not found 


is displayed on the screen. 


Any line ina batch file that begins with: is ignored, that 
is, not executed. 


EXAMPLE 1 


setint count=1 
setint digit=0 
sinput 
echo Enter the number of files you want copied, up to five 
getline digit 
if (digit <1) + (digit >5) then 
{ 
echo invalid entry 
goto input 


endif 


In this example, the label :input marks a position in the 
file and becomes the target for the goto input command. 
The GETLINE command requires you to type a number 
from 1 to 5. If you type a number outside this range, the 
last ECHO command displays invalid entry on the screen; 
program execution returns to :input from goto input, and 
you are prompted again by the first ECHO command to 
enter the number of files you want copied. 
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EXAMPLE 2 


if exist file goto end 
echo file not found 
send 


In this example, if file is found then the message: 
file not found 


is not displayed on the screen, and the batch program 
jumps to the label :end. If file is not found, the message: 


file not found 


is displayed. Labels in a batch program are never 
displayed on the screen while the batch file is executing. 
In this example, the line :end would not be displayed. 
Thus unreferenced labels provide a way for placing 
comments within your batch program that are not 
displayed when the batch file is executed. This technique 
is often useful to remind yourself what you are doing at 
particular points in your batch program. 
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IF 


PURPOSE 


Allows conditional processing of MS-DOS commands. 


SYNTAX 
IF <condition> <statement> 


where: 
condition = an expression to be evaluated as true or 
false 
statement = a command or statement to be executed 
and: 
<> = required information. 


COMMENTS 


The conditional expression is evaluated as either true or 
false, and the single statement following it is executed if 
the evaluation is true. (Refer to the section Conditional 
Expressions earlier in this chapter for an explanation of 
conditional expressions.) You can invert a conditional 
expression by using: 


IF NOT <condition> <statement> 


NOT qualifies the statement so that statement executes 
only if condition is not true. 
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EXAMPLE 


if exist myfile goto try 
goto xfile 

stry 

[command] 

:xfile 


In this example, the IF command executes if myfile is 
found. The GOTO command is executed causing the 
program to jump to the label :try and then execute the 
command on the following line. If myfile is not found, 
the GOTO TRY command would not be executed; instead 
GOTO XFILE would be executed and then the command 
following the label :xfile. 
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IF 


PURPOSE 


ABL’s IF command is an enhanced version of the MS-DOS 
batch processor IF command. As such, its syntax has two 
forms: one that is compatible with the MS-DOS batch 
processor (see IF "MS-DOS and ABL") and one that is for 
the enhanced ABL command language. In both cases, the 
IF command allows conditional processing of MS-DOS 
commands. 


SYNTAX 


IF <condition> THEN <statement> 
[ELIF <condition> <statement>]* 
[ELSE <statement>] 

ENDIF 


where: 
condition = an expression to be evaluated as true or 
false 


statement = a command or statement to be executed 


and: 
<> = required information 
] = optional information. 


* This line can appear more than once. 
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LL 


COMMENTS 


The conditional expression is evaluated as either true or 
false, and the single statement following it is executed if 
the evaluation is true. Each statement can be a compound 
statement. 


The ELIF (else if) and ELSE are optional when you use the 
enhanced version; however, when you use the enhanced 
version and you want to use ELIF or ELSE as well, the 
THEN must be present since it tells the ABL command 
processor that the enhanced version is in effect. 


ELIF is evaluated sequentially and may be present more 
than once within one IF command. This means that if the 
condition following IF is false, then the condition 
following the first ELIF is evaluated. If it is true, then the 
statement following that condition is executed. If it is 
false, then the condition following the next ELIF is 
evaluated. 


When all conditions are evaluated as false, ELSE is 
executed. When one of the conditions associated with IF 
or ELIF is evaluated as true, ELSE is not executed and 
batch-program control jumps to the command following 
ENDIF. You can replace any statement with a compound 
statement by enclosing multiple statements in braces ({}). 
Also, an IF statement can be nested, that is, a second (or 
more) statement can be used after a preceding, higher 
level statement. Every enhanced IF statement must have 
an ENDIF that must be on a line by itself. Refer to the 
section Statements and ABL Processor Conditional 
Expressions earlier in this chapter for more information 
about statements and ABL conditional expressions. 
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EXAMPLE 1 


if exist filel.asm then 
{ 

masm file1 

link filel 

print file1 


elif exist file2.asm 


masm file2 
link file2 
print file2 


else 
echo asm file not found 
endif 


This example shows an enhanced IF command with 
compound statements. If filel.asm is found then file is 
assembled, linked, and printed. However, if filel.asm is 
not found then file2.asm is checked for existence. If 
file2.asm exists then file2 is assembled, linked, and 
printed. Finally, if filel.asm and file2.asm do not exist 
then the message: 


asm file not found 


is echoed to the screen. 
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EXAMPLE 2 


if %1 == progl.asm then 
{ 
if not exist progl.exe then 


masm progl; 
link progt; 


else 
echo executable version already exists no need to assemble 
endif 


elif %1 == progl.doc 


echo program document being sent to printer 
print progl.doc 

} 

else 


echo first argument is incorrect file 
endif 


This example shows nested statements in an enhanced IF 
command. Notice that each if statement is matched with 
an endif. 


This program performs two tasks. It assembles and links a 
program or prints a document file describing that 
program, depending on the filename argument you supply 
on the ABL batch file command line. If you type: 


ABL mybatch progl.asm 


the program acts on the progl.asm file. It assembles and 
links the file if the progt.exe file is not found. If 
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progl.exe exists, the first ELSE statement executes the 
associated ECHO command that displays: 


executable version already exists no need to 
assemble 


and program execution ends with the first ENDIF 
statement. If you type: 


ABL mybatch prog1.doc 


the program acts on the progi.doc file. It executes the 
associated ECHO command that displays: 


program document being sent to printer 


and prints the file. 


The program first looks for the progl.asm file. When you 
type this filename, the program executes as described 
above. When you type prog1.doc, the first IF statement is 
evaluated as false, and, as a result, the ELIF statement is 
then evaluated. Because you typed progl.doc, the ELIF 
statement is evaluated as true, and its associated statements 
are executed. 
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Cl es 


If you type a filename argument other than progl.asm or 
progl.doc, the last ELSE statement is executed where the 
associated ECHO command displays: 


first argument is incorrect file 


In this case, program execution travels from the first IF 
statement to the ELIF statement, to the ELSE statement, 
and ends with the final ENDIF. 
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PAUSE 


PURPOSE 


Stops processing of a batch file until you press a key to 
continue processing. 


SYNTAX 
PAUSE [comment] 


where: 
comment = text to be displayed on your screen 
and: 
[| = optional information. 


COMMENTS 


You may want to suspend processing of a batch file to: 


+ Stop information from scrolling off the screen so 
you can look at an important part of your batch 
program (for example, before an ERASE or COPY 
command) to check the processing. 


+ Stop processing so you can change diskettes. 


Just before the PAUSE command, use the ECHO command 
with a comment to prompt you with a meaningful 
message indicating what action to take when batch 
processing stops. If your comment contains a variable 
whose value you want displayed, you must begin and end 
the variable with a percent sign (%variable%). 
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When the ABL command processor encounters PAUSE, it 
suspends program execution and displays the following 
message: 


Strike a key when ready . 


If you press CTRL-C or CTRL-BREAK, the command being 
executed in the batch file ends, and the program 
terminates. 


The comment argument is optional and is typed on the 
same line as PAUSE to prompt you with a meaningful 
message indicating what action to take when batch 
processing stops. The text of comment is displayed before 
the message: 


Strike any key when ready . 
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If your comment contains a variable whose value you want 
displayed, you must begin and end the variable with a 
percent sign (%variable%). If the ECHO command is OFF, 
the comment is not displayed. If ECHO is ON, "pause" 
and its comments are displayed. 


EXAMPLE 


echo on 

echo place source disk in drive A 
pause 

echo off 


These lines are entered into the batch file. When the 
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batch processor encounters the PAUSE command, it stops 
batch processing and displays: 


Strike any key when ready 


Processing remains suspended until you press a key to 
resume it. 
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REM 


PURPOSE 


Displays an associated "remark" on the screen to tell you 
what is going on at a particular point in the batch 
program. In this way REM is similar to the PAUSE 
command, but, unlike PAUSE, does not stop the 
processing of the batch file. 


SYNTAX 
REM [comment] 


where: 
comment = text to be displayed on your screen 
and: 
[] = optional information. 


COMMENTS 


REM allows any text on the same line as the command to 
be displayed on the screen when a batch file is executing 
and the ECHO command is ON (see the discussion of the 
ECHO command). If ECHO is OFF, comments are not 
displayed. Use only the space, tab, and comma characters 
as punctuation in the text of a REM comment. Other 
punctuation may be interpreted as a drive specifier or part 
of an MS-DOS command. 


The comment argument can contain a variable that you 
must begin and end with a percent sign (%) to have its 
value substituted and displayed. 
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EXAMPLE 


rem this file checks new diskettes 


This line is entered into the batch file. When the batch 
processor encounters the comman<d, it displays: 


rem this file checks new diskettes 
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SET 


PURPOSE 


Defines a global variable that becomes part of the 
operating system environment. 


SYNTAX 
SET [<variable>= <string>] 
where: 


variable = a global character or character string 
string = a character string assigned as the value of 


variable 
and: 
<> = required information 
0] = optional information. 
COMMENTS 


Note: The SET command is not just a batch command. 
It can be used at the MS-DOS prompt (see Chapter 5). 
It is included in this chapter to show how it is used in 
a batch file and for comparing it with setting local 
string variables (SETSTR). 


The SET command is a variable definition command. It 
defines a global variable as containing a specified character 
string that remains in the MS-DOS environment until you 
turn off or reset your computer, or until you erase it by 
setting the variable equal to a null string, that is, 

SET <variable>=. 
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Every character after the = in the SET command is set to 
the variable. String values need not be surrounded by 
quotation marks. (Refer to the sections Variables and 
Statements earlier in this chapter for more information 
about variable types and standard assignment statements.) 


EXAMPLE 


set myname =John A. Doe 


This example shows how SET can be used in an MS-DOS 
or ABL batch file. 
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SETINT 


PURPOSE 


Defines a local integer variable, that is, it sets an integer 
value equal to a local variable. 


SYNTAX 
SETINT <variable> = <arithmetic expression> 


where: 
variable = local character or character 
string 
arithmetic expression = an expression with an 

arithmetic or relational 
operator 

and: 

<> = required information. 


COMMENTS 


The SETINT command is a variable definition command. 
It defines a variable as containing a specified integer that 
is local to the ABL batch file. A local variable is one 
generated for the batch file and exists only for the 
duration of batch file processing; it does not remain in the 
MS-DOS environment. 


(Refer to the section ABL Processor Variables earlier in 
this chapter for more information on local variables.) 
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EXAMPLE 


setint count = 0 
setint count = count + 1 


This example shows how SETINT can be used in an ABL 
batch file. The statement on the second line replaces the 


current value of count with the sum of the current count 
value plus 1. 
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SETSTR 


PURPOSE 


Defines a local string variable, that is, it sets a character 
string equal to a local variable. 


SYNTAX 
SETSTR <variable> = <string> 


where: 
variable = local character or character 
string 
string = a character string 
and: 
<> = required information. 


COMMENTS 


The SETSTR command is a variable definition command. 
If defines a variable as containing a specified character 
string that is local to the ABL batch file. A local variable 
is one generated for the batch file and exists only for the 
duration of batch file processing; it does not remain in the 
MS-DOS environment. 


(Refer to the section ABL Processor Variables earlier in 
this chapter for more information on local variables.) 
EXAMPLE 
setstr myfile = abd 


This example shows how SETSTR can be used in an ABL 
batch file. 
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SHIFT 


PURPOSE 


Allows a batch file to operate on more than 10 arguments 
on the batch file command line by shifting them one 
position to the left. 


SYNTAX 


SHIFT 


COMMENTS 


Up to 10 dummy parameters (%0-%9) may be used ina 
batch file. SHIFT lets you move more arguments into a 
queue, discarding the first argument. 


Such additional arguments (more than 10) should be on 
the same batch file command line in order to be shifted 
into the queue. 


The SHIFT command works like this: 
if %0 = "bak" 
%1 = "art" 
%2 = "budgt" 
%3...709 are empty 

then a SHIFT results in the following: 
%0 = "bak" 


%1 = "budgt" 
%2...%9 are empty 


The %0 parameter is always the name of the current batch 
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processing file and is not affected by a SHIFT command. 


If there are more than 10 arguments given on a command 
line, those appearing after the tenth (%9) are shifted one at 
a time into %9 by successive shifts. 


EXAMPLE 


Suppose you want to make a batch file you can use 
whenever you want to copy a list of any five files from 
drive A to drive B. If the name of the batch file is 
S5COPY.BAT, and the five filenames are FILE1, FILE2, 
FILE3, FILE4, and FILES, you can copy them by typing: 


Scopy file1 file2 file3 file4 files 
The command lines in the 5COPY.BAT batch file are: 


istart 

if not exist %1 goto exit 
copy a:%1 b: 

shift 

goto start 

sexit 


Because each SHIFT command shifts the arguments one 
position to the left, the COPY command will be executed 
each time it finds a filename in the %1 location. 
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You could achieve the same results with the following 
program that uses the DO UNTIL command: 


setint count = 5 
do 
{ 
copy a:%1 b: 
shift 
setint count = count - 1 


until count == 0 


In this case, you should name the batch file 5SCOPY.ATT 
since DO UNTIL is an ABL command, and you would 
have to type the ABL batch file command line: 


ABL Scopy 


You might also set up the program using the GETLINE 
command: 


setint count — 0 
echo enter the number of files you want to copy 
getline count 
do 
i 
copy a:%1 b: 
shift 
setint count = count - 1 


} 


until count ~— 0 
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In this case you should also name the batch file with an 
ATT extension, but you might call it NCOPY.ATT, since 
the GETLINE command will allow you to type in an 
arbitrary number of filenames to be copied from drive A to 
drive B. The ABL batch file command line would be: 


ABL ncopy 


6-85 


Batch Processing Commands 


WHILE 


(ABL) 


WHILE 


PURPOSE 


Allows repeated execution of statements in an ABL batch 
file while a certain condition exists. 


SYNTAX 


WHILE <condition> <statement> 
ENDWHILE 


where: 
condition = an expression to be evaluated as true or 


false 
statement = a command or statement to be executed 


and: 
<> = required information. 


COMMENTS 


WHILE evaluates condition first before executing 
statement. A condition is an expression that evaluates to 
either true or false. WHILE is the opposite of the DO 
UNTIL command in that DO UNTIL executes a statement 
first before it evaluates a condition. You can replace any 
statement with a compound statement by enclosing 
multiple statements in braces (Q). All WHILE constructs 
must be closed with ENDWHILE (similar to ENDIF) that 
must be on a line by itself. (Refer to the section 
Conditional Expressions earlier in this chapter for more 
information about conditional expressions.) 
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EXAMPLE 


setint count=10 
echo off 


while count <>0 


echo Y%count% 

setint count = count - 1 
} 
endwhile 
echo on 


This example shows how WHILE can be used in a ABL 
batch file. When the program is executed, the following is 
displayed: 


aNnuRuaroos 


The program uses SETINT to set the integer count equal to 
10. ECHO is set to OFF. While the count is not equal to 
(<>) zero, the value of the %count% variable is displayed 
by the echo statement inside the WHILE loop. Then, 
using SETINT, 1 is subtracted from the current count by 
setting count equal to count-1. For each execution of the 
loop, 1 is subtracted from the current count. This process 
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continues until the count equals 0 (zero), at which time 
execution stops. Zero is not displayed because WHILE sets 
the condition for displaying to be while the count is not 
equal to zero. 
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Sa 


The new AT&T Help facility delivered with MS-DOS Version 3.2 
enables you to display help information on many of the MS-DOS 
commands and related MS-DOS subjects during the course of 
your work. Help consists of a single command that you can issue 
at the MS-DOS prompt any time you want to view help text. The 
system will display the help text you need or an index of subjects 
for which help is available. 


At the back of this user’s guide, you will find an MS-DOS/AT&T 
Help Diskette that contains the HELP command along with the 
files of help text. You can run HELP directly from it or from 
your fixed disk. 


The Help facility also provides you with a customization 
capability so that you can change the AT&T-provided help text to 
suit your needs better. For example, you may want to add 
additional examples to illustrate a difficult command better. Or, 
you may be using a custom utility or batch file for which you feel 
help would be beneficial. The AT&T Help facility enables you to 
create and access a new set of help files for this purpose. 


This chapter contains instructions for: 


¢ Installing the AT&T-provided help text for MS-DOS 
commands and related subjects on a fixed-disk system ora 
two-diskette system. 


© Using the HELP command to display help text. 


© Customizing the Help facility by modifying the existing 
help text or adding your own set of help text files. 
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Installing Help 
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Before you begin to use the AT&T Help facility, you need to 
understand the structure of the help text files and how they are 
set up. The standard help text—the text provided on the 
MS-DOS/AT&T Help Diskette—contains information on MS-DOS 
commands and other related subjects broken down into topics. 
Each set of help topics (those pertaining to a particular theme) is 
referred to as a category. The category of help topics provided by 
AT&T on the Help Diskette is named DOS. 


The structure of the Help facility consists of the following: 


* Each topic is set up as an individual file within a category. 


* Each category is set up as a subdirectory under one main 
help directory. 


* The main help directory, which is a subdirectory of root, is 
named HELPDIR. This means the DOS category is a 
subdirectory of the HELPDIR directory. Any categories 
you might add in the future will also be subdirectories of 
the HELPDIR directory. 


This help structure is designed to keep all help text together in 
one main directory, while at the same time separating the 
different categories of topics into different subdirectories. To 
access the help text from any directory, you must set the PATH 
variable to the directory containing the HELP command and the 
HELPDIRPATH variable to the directory containing the help text 
files. 


Note: Since the default amount of environmental space 
provided by MS-DOS is small, you may need to increase it 
because of the HELPDIRPATH and PATH variables. You may 
also want to speed up the HELP command by providing more 
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buffers in memory than MS-DOS usually provides. If so, 
enter the following commands in the CONFIG.SYS file: 


buffers=20 
shell=c:\command.com /p/e:500 


Refer to the installation instructions in either the Two-Diskette 
System or the Fixed-Disk System section of this chapter 
depending on the system you are using. 


Two-Diskette System 


Before you use the AT&T Help facility on a two-diskette system, 
all you have to do is make a working copy of the MS-DOS/ 
AT&T Help Diskette and store the master copy in a safe place. 
Once the working copy is made, use it to display existing help 
information and to create new categories if you want. In 
addition, you can create new categories of help topics on blank 
diskettes. 


To make a working copy of the MS-DOS/AT&T Help Diskette: 


1 Insert the MS-DOS System Diskette in drive A. 


2. At the MS-DOS prompt, type: 
diskcopy a: b: 


and press RETURN. 
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This message appears: 
Insert source diskette in drive A 


3. Remove the MS-DOS System Diskette, insert the 
MS-DOS/AT&T Help Diskette, and press RETURN. 


This message appears: 


Insert target diskette in drive B 


4 Insert a blank diskette in drive B and press RETURN. 
(The target diskette will automatically be formatted, if 
needed.) 


5 When the copy is complete, take out the master copy 
and store it in a safe place. Label the working copy and 
use it for help. 


If you create other categories of help topics on blank diskettes, it 
is recommended that you copy the HELP command to each 
diskette. This enables you to use only a single diskette for 
accessing help information instead of two. 


If you have several diskettes of help text files, be sure you are 
using the appropriate diskette for the help text you require. 


To copy the HELP command to another diskette: 


1 Insert the master copy of the MS-DOS/AT&T-Help 
Diskette in drive A and the diskette that you want to 
contain the HELP command in drive B. 
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$a 
2 At the MS-DOS prompt, type: 
copy athelp.exe b: 


and press RETURN. 


Once you have a working copy of Help, refer to Getting Help 
When Only One Category Exists later in this chapter to use help 
as is, or refer to Customizing Help later in this chapter for 
instructions on modifying help text or creating new categories. 


Fixed-Disk System 


Installation of the AT&T Help facility onto your fixed disk 
consists of the following steps: 


* Creating the main help directory. 


* Creating the DOS.CAT subdirectory (under the main help 
directory) and copying the MS-DOS help text files to it. 


© Setting the HELPDIRPATH environment variable in the 
AUTOEXEC.BAT file. This variable enables HELP to find 
the help text files. 


© Updating the PATH variable in the AUTOEXEC.BAT file. 
This variable enables MS-DOS to find the HELP command. 


If you install MS-DOS Version 3.2 using the automatic installation 
procedure, the AT&T Help facility may be installed automatically. 
See the Automatically Setting Up a Fixed Disk section of 
Chapter 3 for complete information on automatic installation. 
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The following procedure shows you how to install the AT&T 
Help facility manually. In some of the steps, the MS-DOS line 
editor is used to edit the AUTOEXEC.BAT file. Please note, 
however, that you can use any editor to edit the file as long as 
you enter the information correctly. 


To install the AT&T Help facility onto your fixed disk: 
1 To make sure you are in the root directory, type: 
C> cd\ 
and press RETURN. 
2 To create the main help directory, type: 
mkdir \helpdir 


and press RETURN. 


(You can substitute another name for the main help 
directory name if you want.) 


3 To make the main help directory the current directory, 
type: 


cd helpdir 


and press RETURN. (HELPDIR is the name of the main 
help directory.) 


7-8 


Getting Help 


To create the DOS.CAT subdirectory, type: 


mkdir dos.cat 


and press RETURN. (The extension .CAT identifies the 
subdirectory as a category of topics.) 


Insert the MS-DOS/AT&T Help Diskette into drive A, 
and then type: 


copy a:help.exe c:\pathname 


and press RETURN. 
(Substitute the name of the subdirectory containing 
your MS-DOS utilities for pathname. If the utilities 


are in the root directory, leave pathname blank.) 


Then type: 
copy a:helpdir\dos.cat\*.* c:dos.cat 


and press RETURN. 


The first command copies the HELP command to the 
subdirectory with other MS-DOS utilities. The second 
command copies the MS-DOS help text files to the 
DOS.CAT subdirectory. 
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6 To set the HELPDIRPATH environment variable equal 
to the main help directory in the AUTOEXEC.BAT file, 
start by typing: 

cd \ 


and press RETURN. (AUTOEXEC.BAT must reside in the 
root directory.) 


7 Type: 
edlin autoexec.bat 


and press RETURN. 


8 At the EDLIN prompt, type: 


9 At the line number prompt, type: 
set helpdirpath=c:\helpdir 


and press RETURN. 


(HELPDIR is the name of the main help directory. 
If you used a different directory name for the main 
help directory, use that name here instead.) 
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If the PATH variable is not set in the AUTOEXEC.BAT 
file, then type: 


PATH~c:\;c:\pathname 


and press RETURN. 

and go to Step 16. 
(Substitute the name of the subdirectory containing 
your MS-DOS utilities, including HELP.EXE, for 
pathname. If the utilities are in the root directory, 
omit the semicolon and everything after it from the 


command line.) 


If the PATH variable has previously been set, type: 


to list the lines of the AUTOEXEC.BAT file. 


At the next EDLIN prompt, type the number of the line 
that sets the PATH variable. 


At the line number prompt, press the right arrow key 


(—) five times, so that the following characters appear 
on your screen: 


path= 
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14 


15 


16 
17 
18 


Press the INS key once, and type: 
c: \pathname; 


where pathname is the name of the subdirectory 
containing your MS-DOS utilities, including HELP.EXE. 
If the utilities are in the root directory, leave pathname 
blank. 


Press the INS key again, then press F3, then press 
RETURN. 


Press CTRL-Z. 
Press RETURN. 


At the EDLIN prompt, type: 


The MS-DOS prompt is displayed. 


Before you can begin using HELP, you must reboot your 
system. 
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Using Help 


Before you use the HELP command, be sure you have installed 
the help files onto your fixed disk if you have a fixed-disk system; 
or inserted the diskette(s) in the proper drive(s) if you have a 
two-diskette system. 


The general syntax for HELP is: 


HELP [category] [topic] 


where: 
category = the name of the category containing the 
topic in which you are interested. You 
only need to concern yourself with this 
argument if you have added other 
categories of help topics. 
topic = the name of the topic you want to view. 
and: 
[] = optional information. 


Note: If you use the HELP command with both arguments, 
you must specify the category name before the topic name. If 
you specify only one argument, HELP determines whether 
the argument is a topic or a category. If you do not specify 
an argument, HELP displays a category index (if you have 
multiple categories) or a topic index (if you have a single 
category). 


The procedure for getting help differs slightly depending on the 
number of categories you are working with. As mentioned 
above, if you plan to use the Help facility with the DOS category 
only, you do not need to concern yourself with how to get help 
from multiple categories. However, if you add additional 
categories of topics (see Customizing Help later in this chapter), 
there are additional steps to getting help that you need to know. 
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The following sections describe two procedures for getting help. 
If you have only one help category (such as DOS), refer to 
Getting Help When Only One Category Exists. If you have 
added other categories, refer to Getting Help When Multiple 
Categories Exist. 
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Getting Help When Only One 
Category Exists 


ee ee 
There are two ways to get help from the DOS category: 
* You can choose a topic from an index listing all the topics 


included in the DOS category. 


* You can type the name of the topic as an argument to the 
HELP command (bypassing the index). 


Using the Topic Index 


The topic index lists the topic names contained in a single 
category. It is a good idea to display the topic index when you 
are not sure of the topics available to you. The topic index lists 
the available topic names in five columns on the screen; topics are 
arranged alphabetically across the screen. 


To display the topic index for the DOS category: 


1 Make sure you have previously installed help if you are 
using a fixed disk, or inserted the appropriate diskette(s) 
in the appropriate drive(s) if you are using a two- 
diskette system. 


2 At the MS-DOS prompt, type: 
help 


and press RETURN. 
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The screen displays a topic index similar to the one 


below: 


TOPIC INDEX pos AT&T 
Tot 2 
Ansi.sys APPEND ASSIGN Autoexec.bat BACKUP 
BREAK cp CHOIR cupsK cHHoD 
cis COMMAND Command.com COMP Config.sys 
copy crry DATE Debug DEL 
Devices DIR Directories DISKCOMP DISKCOPY 
Driver.sys rivers ECHO Edlin ERASE 
EXE2BIN EXEC EXIT FC FDISK 
Files Filters FIND Fix Help FOR 
FORMAT oto GRAPHICS GwBasic HELP 
IF JOIN LABEL Link MD 
MKDIR MODE Modify Help MORE House 
PATH PAUSE PRINT Printing PROMPT 
Ramdrive.sys RD RECOVER Redirection REM 
RENAME REPLACE RESTORE RMDIR Root 
SET SHARE SHIFT SurP SIZE 
SORT Starting MSDOS SUBST syntax sys 
TAG TIME TREE TYPE UNTAG 
PgDn for more 
ESC to display categories 
Enter topic name: Ansi.sys 
A device driver that modifies keyboard input and screen output 


The topic names displayed on the screen are shown in 
uppercase (actual commands) or in mixed case (related 
subjects). The difference in case is to help you 
distinguish between MS-DOS commands and other 
subjects. (This format is for your convenience; it is not a 
requirement.) However, when you choose a topic, type 
the name in the case you are most comfortable with. 


Since the list of available topics may extend beyond the 
current screen, you can use the following keys to page 


through the index: 
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PG DN Pages the topic index to the next screenful of 
topic entries. 

PG UP Pages the topic index to the previous 
screenful of topic entries. 

HOME Displays the first screenful of topic entries in 
the index. 

END Displays the last screenful of topic entries in 
the index. 


When you locate the topic you want to view, there are two 
ways you can select it from the index: 


° Type the name of the topic in response to the prompt 
at the bottom of the screen: 


Enter topic name: 


and press RETURN 


* Highlight the name using the cursor control keys (f, |, 
— or +) and press RETURN. 


MS-DOS automatically fills in the prompt: 
Enter topic name: 


with the highlighted topic name. 


When you use the second method, MS-DOS displays a brief 
description of the topic on the line after the "Enter topic 
name:" prompt. This description enables you to be sure that 
the highlighted topic is, in fact, the one you want to view. 


TAT 
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Specifying a Topic Name 


Instead of choosing a topic from the topic index, you can display 

help text directly from the MS-DOS prompt by specifying a topic 

name with the HELP command. The syntax for HELP in this case 
is: 


HELP [topic] 
where: 
topic = the topic name of your choice 
and: 


[] = optional information. 


For example, to view the help text for the COPY command in the 
DOS category, at the MS-DOS prompt, type: 


help copy 


and press RETURN. 
The first screen of help text for the COPY command is displayed. 
Note: If you enter an invalid topic (that is, you spelled the 


name incorrectly or the topic is not found in the current topic 
index), the screen displays the following error message: 


HELP: ‘topic’ is not a valid topic or category name 


where ‘topic’ is the name you typed previously. 


Re-enter a valid topic if this occurs. 
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Reviewing Help Text 


Each topic that is an MS-DOS command consists of two levels of 
information. The first screen, referred to as "quick reference,” 
displays the topic name, syntax (if any), a brief definition, and 
definitions of any options (if applicable). The quick reference 
screen is limited to the first screen you see. 


The second and subsequent help text screens consist of detailed 
information. This level displays the topic name, synonyms (if 
any), syntax, an in-depth definition, expanded definitions of 
options (if applicable), and examples of common usage. The 
detailed information uses as many screens as necessary to cover 
the topic. 


Topics other than MS-DOS commands may not lend themselves 
to the two-level format and, therefore, may consist of only a 
single detailed level. 


The quick-reference screen for the COPY command looks similar 
to the one displayed on the next page. 
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f cory pos 
|copy (drive: ii pach)<titenanel exti> (/¥) (7a) (8) 
(arive:] (pach {¢tiename( exe) (/¥) (7a) (78) 


copy (drive: {path} 


(ently + (drive: }(parndetitenanet exe l> 
[fariver dU parm deste > 


|ectory of disk: also concatenates one file to the end of ancther file 


(/V) verities chat sectors are copies without errors 
[JA] copies fi1es in ASCEE = 
[7B] copies files in BINARY ode 


[Copies a tite or set of files fros « directory or disk to another dir- 
| 


Poon for wore 


CTRL END to exit | 


| 
|esc to display topice 
| Enter consand 


Note: If this screen is not currently displayed, follow the 


instructions in the previous section to display the help text of 
the COPY command. 


To familiarize yourself with the help text: 


1 Read the quick-reference screen to become familiar with 
the format of help text for MS-DOS commands. 
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Press PG DN to view the first screen of the detailed 
information level. The screen displays: 


[cory bos 


Ant 


2 of & 
Copy (drive:}(path]<t11ename(.ext}> (/¥) (7A) (3) 
(drive: }{path)(¢ienazel .ext}) (/¥) (7A) (78) 


copy (drive: ){ path] <ti1eni 


on 
sel ext ]> + (drive: }{path}<filenamel ext )> 


Copy {i108 


[drives] spectties the drive containing the source f11e (the one to 
copy PROM) that you vant to copy 


current drive 49 aeaus 


Pgpn for sore 


ESC to display topics CTRL END to exit 
Enter coseand 


3 Use PG DN, PG UP, HOME, and END to move back and 
forth through the help screens of the COPY command. 
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Exiting From Help 


There are several methods of exiting from help: 


You can press CTRL-END to exit from any screen in the 
Help facility and return to the MS-DOS prompt. 


You can press ESC to return to a previous screen or 
prompt. You can press ESC repeatedly to back through a 
sequence of screens or prompts. For example, if you press 
ESC while help text is displayed, you are returned to the 
topic index. From the topic index, you can press ESC to 
return to the MS-DOS prompt. 


You can type a command (such as a batch filename, a 
start-up command for an application, or another MS-DOS 
command) in response to the prompt: 


Enter command: 


and press RETURN. 


When you enter a command at this prompt, help is exited 
and the command is executed if it is valid. Entering a 
command this way is helpful since you can look at the 
syntax shown on the help screen while you enter the 
command. In addition, if there are cross-references to 
other help files on the current help screen, you can enter 
the HELP command to view that help text. 


Note: You cannot enter commands that change 
environment variables (such as PATH, SET, or 
PROMPT) from within HELP. The only way to 
change the values of environment variables is from the 
MS-DOS prompt. (See the next bullet item.) 

Similarly, you may not be able to start a certain 
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application this way. If you cannot run an application 
from within HELP, exit from HELP and then enter the 
startup command at the MS-DOS prompt. 


* You can press SHIFT-END to exit from any topic in the 
Help facility and return to the MS-DOS prompt. The 
quick reference page of that topic is displayed above the 
MS-DOS prompt. Although you can use this method of 
exiting at any time, some help topics display a message 
instructing you to exit in this manner. This means that 
the command currently described on the screen cannot be 
changed from within help. These commands, such as 
PROMPT, SET, or PATH, are environment variables that 
must be changed at the MS-DOS prompt. 
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Getting Help When Multiple 
Categories Exist 


The instructions in this section apply only when there is more 
than one category of topics in the Help facility. Similar to a topic 
index that lists the available topics pertaining to a category, there 
is also a category index that lists all the categories in the main 
help directory. 


Using the Category Index 


The category index contains the names of the categories 
contained in the main help directory. This index lists the 
categories in five columns on the screen; the categories are 
arranged alphabetically across the screen. The category index 
appears only if you have added other help categories to the main 
help directory. 


To display the category index: 


1 Make sure you have previously installed help if you are 
using a fixed disk, or inserted the appropriate diskette(s) 
in the appropriate drive(s) if you are using a two- 
diskette system. 


2 At the MS-DOS prompt, type: 
help 


and press RETURN. 
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The screen displays a category index similar to the one 


below: 
7 CATEGORY INDEX C:/HELPDIR ater 5 
tof 1 
DATABASE DEBUG pos EDLIN 


CTRL END to exit 
Enter category name: DATABASE 


There are two ways to select the category you want from the 
category index: 


° Type the name of the category in response to the prompt 
at the bottom of the screen: 


Enter category name: 


and press RETURN. 
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° Highlight a category name using the cursor control keys 
(1, |, +, —) and press RETURN. You can also use PG UP, 
PG DN, HOME, and END to move through category indexes 
that are more than one page. 


Upon choosing a category, the topic index for that category is 
displayed. Then, you can choose a topic in the same manner as 
selecting a category from the category index, that is, type the 
topic name or highlight it using the cursor control keys and press 
RETURN. (Refer to Using the Topic Index earlier in this chapter 
for complete instructions on choosing a topic from the Topic 
Index.) 


When you have selected a topic and the help text is displayed, 
you can use PG DN, PG UP, HOME, and END to move through the 
help screens. 


When you are through viewing the help text, there are three 
ways to exit from help: 


° Press CTRL-END to return to the MS-DOS prompt from 
any point in the Help facility. 


* Press ESC once to return to the previous screen or prompt, 
or repeatedly until you exit help 


¢ Enter a command. 


Refer to Exiting From Help earlier in this chapter for complete 
instructions on exiting from help. 
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Specifying a Category Name 


Specifying a category name with the HELP command enables you 
to display the topic index for a category without having to use 
the category index. The syntax for HELP in this case is: 


HELP [category] 


where: 


category = category name of your choice 
and: 


{] = optional information. 


For example, to display the topic index for a category named 
DATABASE from the MS-DOS prompt: 


1 Type: 
help database 


and press RETURN. 


2 Look over the available topics displayed on the screen 
for the DATABASE category. Refer to Using the Topic 
Index earlier in this chapter for instructions on choosing 
a topic from the topic index. 
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If you specify a name that is both a category name and a 
topic name, the following message is displayed: 


‘name’ is both a valid topic name and a valid category name. 
Enter a C or c if you want the category by this name, or 
enter a T or t if you want the topic(s) by this name, or 
press ESC to exit. 


where ‘name’ is the topic or category name you 
specified. 


In this case, enter c if you want to display the category 
index for the category by that name or t if you want to 
display the topic information for the topic by that name. 


Specifying a Category Name and a Topic Name 


Specifying a category name and a topic name with the HELP 
command enables you to access help text from any category 
quickly without having to go through the indices. 


Note: When you specify both of these arguments, it is 
important that you specify the category name first. The HELP 
command always reads the first argument as the category 
name and the second argument as the topic name. 
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The syntax for help in this case is: 


HELP [category] [topic] 


where: 
category = category name of your choice 
topic = topic name of your choice 
and: 
[] = optional information. 


For example, assume you add a category of help topics named 
EDITOR to the main help directory. (See Adding a New 
Category later in this chapter for instructions on adding a 
category of help topics to the main help directory.) The main 
directory now has two categories: DOS and EDITOR. The 
EDITOR category contains help topics regarding the use of your 
word processing application program. You are editing a long 
contract agreement that requires the substitution of a client name. 
You are not sure how to use the global search and replace feature, 
and decide to get help. 


To display help text on a topic named GLOBAL in the EDITOR 
category: 

1 Save your work and display the MS-DOS prompt. 

2 If you are using a two-diskette system, insert the help 


diskette containing the HELP command and EDITOR 
category ina drive. 
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3 Type: 


help editor global 


and press RETURN. 


The screen displays the help text regarding the global 
search and replace feature. (See Reviewing Help Text 
and Exiting From Help earlier in this chapter if you 
need information on viewing the help text or exiting 
from it.) 


Invalid Entries 


* If you had typed an invalid topic in the previous example, 
the screen would have displayed the topic index for the 
specified category and the message: 


‘topic’ not found 


where ‘topic’ is the name you specified. 


Look over the index for the desired topic and choose it 
from the index. See Using the Topic Index earlier in this 
chapter if you need instructions. 


If you had typed an invalid category along with a valid 
topic in the previous example, the screen would have 
displayed the category index and the message: 


‘Category’ not found. 
‘topic’ found in yellow (or flashing) categories 
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Choose a category that is displayed in yellow or flashing 
video. (These are the categories that contain the topic you 
specified.) When you select a category shown in yellow or 
flashing video, the help text on the topic you originally 
specified is displayed. 


Note: On color monitors, the name appears in yellow. 
On monochrome monitors, the name appears in 
flashing video. The Help facility enables you to toggle 
between color and monochrome display by pressing 
CTRL-T. Switching video attributes enables you to 
improve video appearance on monochrome monitors. 


If you had typed an invalid category and an invalid topic 
in the previous example, the screen would have displayed 
the MS-DOS prompt and the message: 


Neither category ‘category’ nor topic ‘topic’ 
found 


This means that MS-DOS did not find the specified 
category and topic in the main help directory. Use the 
HELP command by itself to display the category index and 
choose the category you want. 
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The AT&T Help facility enables you to customize help text files in 
two ways: 


* You can add separate categories of help topics to the main 
help directory. 


* You can add, change, rename, or delete any topic 


information (in the DOS category or any categories you 
subsequently create). 


To customize help text files, you need: 


° A text editor 
° A knowledge of some basic MS-DOS commands 


* An understanding of the help file structure. 


Adding a New Category 


Before you add a new category of help topics, remember that 
there is one main help directory. This help directory contains the 
DOS category and will contain any new categories that you want 
to create. To create a new category, you simply create a new 
subdirectory. 


The new subdirectory (category) will contain the new help text 
files that pertain to the new category. Each help text file will 
contain information regarding a specific topic. 


Example 


Assume you have a database program that is somewhat difficult to 
use and you want help available to other users. The first step to 
take when you want to create help text for an application 
program is to devise a list of topics that you want covered and 
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develop the actual text. Once you have done this preliminary 
work, you are ready to add a category. The following steps show 
you how to create a new category: 


1 To make the current directory the main help directory, 
type at the MS-DOS prompt: 


cd \helpdir 


and press RETURN. 


Note: If you changed the name of the main help 
directory when you installed HELP, substitute that 
name for helpdir. 


2 Type at the MS-DOS prompt: 
mkdir database.cat 


and press RETURN. 


You have now added the subdirectory and category name 
DATABASE to the main help directory. 


Guidelines for Creating Help Text Files 


Use the following rules and guidelines when you create or edit 
help text files. It is important that you follow these guidelines 
exactly for HELP to function properly. 
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It may be a good idea to view some files in the DOS category 
before creating your own. 


* The AT&T Help facility automatically creates and/or 
updates the topic indices or category index from the file 
names and subdirectory names you create or modify; you 
do not have to concern yourself with the indices. 


Any categories you add to the main help directory must 
have a subdirectory name that includes the desired 
category name and the extension .CAT. Category names 
must be unique in the main help directory. 


You must create a single file for each topic and provide 
the help text. 


When you create help text files, make sure you are in the 
subdirectory (category) that you want to contain those files 
(topics). Otherwise, use the COPY command to copy the 
help text files to the appropriate categories. 


The help text files you add to a new category or an 
existing category must have the filename extension .PLH, 
which is HLP backwards. 


Filenames (excluding the .PLH extension) cannot exceed 
eight characters. Topic names are specified in the file. 
The topic name and filename do not have to be the same. 
Filenames must be unique in each subdirectory; topic 
names must be unique in each category. 


Help files can only contain standard ASCII characters. 
This means that if your editor cannot convert files to 
ASCII format, you must create the files yourself without 
using any special characters, formatting tools (indents and 
tabs), or pages. The Help facility does not work with files 
other than ASCII. You can use the text editor EDLIN 
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supplied on the MS-DOS System Diskette to create ASCII 
files. 


The maximum number of lines (including blank lines) you 
can have per page in a help text file is 17. 


To indicate a new page, type: 
PG 


in uppercase on a line by itself without any preceding 
blank spaces. This means you insert a .PG after every 17 
lines (or less) of text until you reach the end of the file. 


Note: More than 17 lines per page causes a blank 
page in the actual help display; check your line count. 


The maximum number of characters (including blank 
spaces) you can type per line is 74. 


The first line of the file must contain a .TP (without any 
preceding blank spaces) in uppercase, followed by the 
topic name. Topic names should not exceed 14 characters. 
Those that do are truncated to the first 14. Topic names 
can be typed in uppercase, lowercase, or both. 


For every file you create, you must type on the first line: 


.TP <topic> 
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where: 
topic = name of the topic you are adding 
and: 
<> = required information. 


The topic name will appear in the border of the Help 
screen exactly as you enter it on this line. (You can use 
any character in a topic name; however, you cannot use 
blank spaces. To separate words in a topic name, use 
punctuation such as an underscore or period.) 


The second line of the file must contain a .DES in 
uppercase, followed by a brief description of the topic if 
you wish. This is the line that is displayed beneath the 
prompt: 


Enter topic name: 


when a topic entry is highlighted on an index. The total 
length of this line cannot exceed 74 characters. For every 
file you create, you must type on the second line: 


-DES [topic description] 


where: 
topic description = brief description of topic 
and: 
[] = optional information. 


Note: You do not have to create your help files in the 
two-level format discussed earlier in Using Help. You 
can use any format you desire as long as you follow 
the rules and guidelines listed in this section. 
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* A SD (syntax display) is optional. It displays the 
message: 


Use SHIFT END before using ‘topic’ command 


for the files that contain it. Exiting from a topic by 
pressing SHIFT-END causes the MS-DOS prompt to be 
displayed and the quick reference page of the topic to 
be displayed above the MS-DOS prompt. 


The .SD should be inserted in the file before the first 
-PG. It is recommended that you use .SD when 
describing commands which should not be used from 
within the AT&T Help facility. 


Possible Errors in Creating Help Text Files 


The .TP and .DES lines must be included in each help text file. 
The HELP program uses the .TP and .DES lines as instructions to 
display the topic information correctly. Each file in the help 
directory is checked for these two lines. If the lines are not 
included or if they have been entered improperly, the .PLH 
extension of the incorrect files will be changed to .BAD. Files 
with a .BAD extension are not listed in the topic index; however, 
the message 


* BAD’ or ’.DPx’ files in this category; see ‘Fix Help’ 


is displayed when the topic index for that category is displayed. 
If .BAD files occur in your categories, you must edit the first two 
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lines to correct them and then rename the files with .PLH 
extensions using the REN command. This procedure is described 
in Fix_Help, a help topic in the DOS category. 


Similarly, if two files in the same category are created or exist 
with the same topic name, the .PLH extension is changed to .DPx. 
This means duplicate (because the topic names are the same) files 
exist; x is a letter that identifies the group of files containing the 
same topic name. The first file found containing a duplicate topic 
name is given an extension of .PLx and appears as such in a 
directory listing. All other files with the same topic name are 
given an extension of .DPx and do not appear on the topic index. 
When the duplicate files are detected, the message: 


*.BAD’ or ‘.DPx’ files in this category; See ‘Fix_Help’ 


is displayed when the topic index is displayed. If .DPx and .PLx 
files occur in your categories, you must change the topic name in 
at least one of the files and then rename the files with .PLH 
extensions using the REN command. 


Modifying Help Text Files and Topic Information 
You can modify any help file information using MS-DOS 
commands and the text editor of your choice. This includes: 

© To add a topic to a category, create a file in the appropriate 


subdirectory using your text editor to enter text. 


© To change the help text on a topic, edit the file using your 
text editor. 


Getting Help 


* To rename a help text file, use the MS-DOS command 
REN. To rename a topic, edit the file. 


* To delete a help text file and, therefore, a topic, use the 
MS-DOS command DEL or ERASE to delete the file 
containing the topic. 


* To copy a topic to another category, use the MS-DOS 
command COPY to copy the help text file to the 
appropriate subdirectory. 


The following sections show you how to add and modify topic 
information. Refer to Guidelines for Creating Help Text Files 
for the rules that apply to topic and file formats. Refer to 
Chapter 5, MS-DOS Commands, if you need information on any 
MS-DOS command. 


Adding a Topic 


To add a topic, you create a file and use your text editor to enter 
text. For example, since "Record" is a common term in a database, 
make it your first help topic in the DATABASE category. 


To do so: 
1 Make sure you are in the DATABASE subdirectory. If 


you are not, use the CD command to change to that 
subdirectory. 
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Type: 
te record.plh 


(Substitute the start-up command for your text editor 
for te.) 


and press RETURN. 


When the file is open, type on the first line: 
-TP record _def’n 

Type on the second line: 
-DES a group of related data fields 


Type the rest of the text that you want to use to describe 
a record. Remember, use only ASCII characters and 
insert a .PG after every 17 lines in the file. 


When you have finished entering text for the 
RECORD.PLH file, review what you have typed, and 
then save the file according to your editor instructions. 


In a similar manner, create any other .PLH files that you 
want included for the database category. 
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Modifying Help Text 

To edit the help text ona topic, use your text editor to open the 
file you want to change and retype the information you want to 
edit. 

Renaming Files and Topics 


If you want to change a topic name keep in mind that topic 
names should not exceed 14 characters; those that do are 
truncated to the first 14. 


For example, to change the topic name "Record_Def'n" to 
"Records" in the EDITOR category: 


1 At the MS-DOS prompt, type: 


te record.plh 


(Substitute the start-up command of your editor for 
te.) 


and press RETURN. 


2. Go to the topic name line and change "Record _Def’n" to 
"Records." 


3 Check the file for other references to "Record_Def’n" and 
change them accordingly. 


4 Save your file. 
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If you want to rename a file, use the MS-DOS command REN. 
For example, to rename the file SORT to DATASORT: 


Make sure \helpdir is your current directory. 


2° WITH A FIXED-DISK SYSTEM, type at the MS-DOS 
prompt: 


ren sort.plh datasort.plh 


and press RETURN. 
WITH A TWO-DISKETTE SYSTEM, insert the diskette 


containing the SORT.PLH file in a drive and type at the 
MS-DOS prompt: 


ren sort.plh datasort.plh 
and press RETURN. 


Deleting a Topic 


If you want to delete a topic from a category, use the MS-DOS 
command DEL or ERASE. The Help facility automatically updates 
the topic index. 


For example, to delete the topic Field from the DATABASE 
category: 


1 Make sure \helpdir is your current directory. 
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2 WITH A FIXED-DISK SYSTEM, type at the MS-DOS 
prompt: 


del field.plh 


and press RETURN. 


WITH A TWO-DISKETTE SYSTEM, insert the diskette 
containing the FIELD.PLH file into a drive and type at 
the MS-DOS prompt: 


del field.plh 
and press RETURN. 
Copying a Topic 


If you want to copy topics from one subdirectory (category) to 
another, use the MS-DOS COPY command. 


For example, to copy the topic Directories from the DOS category 
to the DATABASE category: 


Make sure \helpdir is the current directory. 


2. WITH A FIXED-DISK SYSTEM, type at the MS-DOS 
prompt: 


copy \dos.cat\directry.plh c:\helpdir\database.cat 


and press RETURN. 
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WITH A TWO-DISKETTE SYSTEM, insert the diskette 
containing the DIRECTRY.PLH file into a drive and type 
at the MS-DOS prompt: 


copy\dos.cat\directry.plh a:\helpdir\database.cat 


and press RETURN. 
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Introduction 


This appendix contains an alphabetical listing of the messages 


that MS-DOS displays when it is unable to perform a requested 
task. 


Many of the messages you may encounter when using MS-DOS 
refer to problems in reading from or writing to devices such as 
disk drives or printers. These messages are called device errors. 
Other common error messages that you may encounter from time 
to time are related to the specific command or task that you are 
trying to perform. 


Included in the list of messages is the name of the command 
associated with the displayed message. All messages appear in 
bold type. In some cases, messages can begin with or contain a 
filename or a number that varies depending on what you specify 
or do. Such messages are alphabetized by the word or letter that 
represent what the real word or number could be. These words 
or letters are printed in italic. For example: 


filename file not found 


where: filename is the name of a file you supply. 


Head: hh Cylinder: cc 


where: hh and cc are numbers. 


n lost clusters found in m chains 


where: n and m are numbers. 


Also, Help error messages are those that the Help facility displays 
in response to the HELP command line and prior to display of 
the first help screen. All other Help error messages (those 
displayed on help screens) are self-explanatory. 
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Device Errors 


All device error messages take one of two forms: 


type exror reading/writing device 
Abort, Retry, Ignore?_ 


or 


yyy ERROR WHILE |/Oaction ON DRIVE x 
Abort, Ignore, Retry:_ 


where: 
type and yyy = device error 
1/O action = READING or WRITING 
x = designation of drive where problem 
occurred. 


The following is a list of device errors: 


Bad call format* Non-MS-DOS disk 
Bad command Not ready 

Bad unit* Read Fault* 

Data* Sector not found* 
Disk* Seek* 

General failure* Sharing violation 
Invalid disk change Write fault* 
Lock-Violation Write protect 

No paper 


* If you see multiple occurrences of any of these messages, 
contact your authorized AT&T dealer. 
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When you receive one of these messages, you have the choice of 
doing one of the following: 


© Type: 
a 


for Abort. This ends the program that requested the read 
or write. 


° Type: 
r 
for Retry. This causes your computer to reattempt the 
operation. Correct the problem that caused this message, 
if you can, and type: 


r 


for Retry. 
° Type: 
i 
for Ignore. This causes your computer to ignore the 


problem and attempt to continue the program. If you 
choose this option, you may lose some data. Be careful. 


These device error messages are described along with the rest of 
the error messages in the list of MS-DOS messages. 
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- or .. does not exist (CHKDSK) 
This is an informational message from CHKDSK. This 


message indicates that either the. or the .. directory entry is 
invalid. 


0 cylinders not valid (FDISK) 
You tried to create a partition of size 0 cylinders. Enter a 
non-zero response to the prompt for the partition size. 


Abnormal program termination (TAG/UNTAG/EXEC) 
There is insufficient disk space or memory or you are using 
the incorrect version of MS-DOS to complete the requested 
TAG/UNTAG/EXEC operation. See the following error 
messages for the cause of and solution to this problem: 


Insufficient disk space (TAG/UNTAG) 


Insufficient memory (TAG/EXEC) 
Need MS-DOS 3.0 or greater (TAG/UNTAG/EXEC) 


Abort, Retry, Ignore? (device error) 
If a device error occurs at any time during a command or 
program, MS-DOS displays this message and asks you to abort 
the command or program, retry it, or ignore the error. 


Access denied (XCOPY) 
You tried to overwrite a read-only file. 


Access denied filename (REPLACE) 
You tried to replace a write-protected or locked file. 


All files canceled (PRINT) 
If you specify the /T (Terminate) option, MS-DOS prints: 


All files canceled by operator 
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OO ______. 


on your printer. If the current file being printed is canceled 
by a /C, the message: 


File canceled by operator 


is printed. 


All specified file(s) are contiguous (CHKDSK) 
The file or files you named are all written sequentially on 
disk. 


Allocation error, size adjusted (CHKDSK) 
The file allocation table contains an invalid sector number. 
The file is truncated at the end of the last valid sector. 
CHKDSK has automatically performed the only remedy 
available at this point 


Are you sure (Y,N)? 
MS-DOS displays this message if you try to delete *.* (all files 
in the directory). Specify y or n. 


Attempted write-protect violation (FORMAT) 
The disk you are trying to format is write protected. 


Bad call format error (device error) 
A request header of incorrect length was passed to a device 
driver. Contact your authorized AT&T dealer for more 
information. 


Bad command error (device error) 
A device driver has issued an invalid command to the named 
device. Contact your authorized AT&T dealer for more 
information. 
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Bad command or file name 
The command cannot find the file you asked it to run. You 
either mistyped the filename or the file does not exist on the 
disk. 


Bad Partition Table (FORMAT) 
There is no MS-DOS partition on the fixed disk. Run FDISK 
to create an MS-DOS partition on your fixed disk. 


Bad unit error (device error) 
An invalid subunit number has been sent to a device driver. 
Contact your authorized AT&T dealer for more information. 


Boot failure 
An error occurred while attempting to read the disk from 
which you are booting. This is a hardware problem. Try 
rebooting one or more times by pressing the RESET button. 
Contact your authorized AT&T dealer for assistance. 


Cannot CHDIR to filename 

Tree past this point not processed (CHKDSK) 
CHKDSK is traveling the tree structure of the directory and is 
unable to proceed to the specified directory. All 
subdirectories and files under this directory are not verified. 


Cannot CHDIR to root 

Processing cannot continue (CHKDSK) 
CHKDSK is traveling the tree structure of the directory and is 
unable to return to the root directory. CHKDSK is not able to 
continue checking the remaining subdirectories to the root. 
Try to restart MS-DOS. If this error persists, the disk is 
unusable. 
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Cannot DISKCOMP to or from a network drive (DISKCOMP) 
One of the drives that you specified is a network device. 


Cannot DISKCOMP to or from an ASSIGNed or 

SUBSTed drive (DISKCOMP) 
One of the drives you specified is a drive you created using 
the ASSIGN or SUBST command. 


Cannot DISKCOPY to or from a network drive (DISKCOPY) 
You are trying to DISKCOPY to or from a network drive. 


Cannot DISKCOPY to or from an ASSIGNed or 

SUBSTed drive (DISKCOPY) 
You are trying to DISKCOPY to or from a "virtual" drive that 
was created by using the SUBST or ASSIGN command. 


Cannot do binary reads from a device (COPY) 
You have tried to use the /B option with the name of a 
device. Place an /A option after the device name to copy in 
ASCII mode. 


Cannot FORMAT a Network drive (FORMAT) 
You cannot format drives that are redirected over the 
network. 


Cannot format an ASSIGNed or SUBSTed drive (FORMAT) 
You attempted to format a drive that is actually mapped to 
another drive by the ASSIGN or SUBST command. Run 
ASSIGN or SUBST again and clear all drive assignments. 


Cannot label a network drive (LABEL) 
You cannot label a drive that is shared on a network server 
station. 
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Cannot LABEL a SUBSTed or ASSIGNed drive (LABEL) 
You cannot label a drive that has been assigned via the 
ASSIGN command or that has been substituted with a string 
via the SUBST command. 


Cannot open filename (PRINT) 
Either MS-DOS cannot find the specified file to print or the 
file does not exist. Check the command for a valid filename. 


Cannot perform a cyclic copy (XCOPY) 
When you are using the /S option, you may not specify a 
target that is a subdirectory of the source. 


Cannot recover . entry, processing continued (CHKDSK) 
The . entry (working directory) is defective. 


Cannot recover .. entry (CHKDSK) 
The .. (parent directory) entry is defective. 


Cannot XCOPY from a reserved device (XCOPY) 
You cannot copy from a device to a file. 


Cannot XCOPY to a reserved device (XCOPY) 
You cannot copy files to a device. 


COM port does not exist (MODE) 
You have specified an invalid COM port. 


COMMAND.COM is invalid: (EXEC) 
The COMMAND.COM file was needed to perform the 
MS-DOS command specified as an argument to the EXEC 
command, but was corrupt or incompatible with the rest of 
MS-DOS. Restart your computer with the MS-DOS System 
Diskette in drive A and try again. 


Appendix A 
Messages 


Compare another diskette (Y/N)? (DISKCOMP) 
After comparing the disks, DISKCOMP asks if you want to 
compare another disk. Press y or n. 


Compare error on side nnn, track nnn (DISKCOMP) 
DISKCOMP found an error on side nnn, track nnn. 


Compare OK (DISKCOMP) 
DISKCOMP displays this message if the disks are identical. 


Compare process ended (DISKCOMP) 
DISKCOMP displays this message if a fatal error occurred 
during the comparison. 


Comparing tt tracks xx sectors per track, y side(s) (DISKCOMP) 
This message gives the format (of the first disk) that 
DISKCOMP is using to perform the comparison. 


Content of destination lost before copy (COPY) 
A file to be used as a source file has been overwritten prior to 
completion of the copy. Example: 


copyxt+yy 


which destroys y before it can be copied. 


Copy another (Y/N)? 
Respond y if you wish to copy another disk. Respond n if 
you do not wish to copy another disk. 


Copy another diskette (Y/N)? (DISKCOPY) 
You are prompted to see if the DISKCOPY process is to be 
repeated on another source/target disk. 
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Copy complete (DISKCOPY) 
The DISKCOPY program has completed processing. 


Copy not completed (DISKCOPY) 
DISKCOPY cannot copy the entire disk. Use the COPY 
command to copy specific files onto another disk. 


Copying ... (DISKCOPY) 
This message indicates that the DISKCOPY program is 
copying a disk. 


Copying nn tracks nn Sectors/Track, 
nn Side(s) (DISKCOPY) 
DISKCOPY describes the format of the source disk. 


Current date is mm-dd-yy (DATE) 
This message appears when you first start MS-DOS; mm-dd-yy 
is month-day-year. 


Current time is hh:mm:ss.hh (TIME) 
This message appears when you first start MS-DOS; the first 
hh is hours, mm is minutes, ss is seconds, and the last hh is 
hundredths of a second. 


Cylinder starting cylinder number contains too many bad 

sectors. Define another partition (FDISK) 
FDISK tolerates up to five bad sectors in the first cylinder of a 
partition before it displays this message. Enter the partition 
size and a different starting cylinder number in response to 
the prompts. 


Data error (device error) 
Data could not be read/written correctly because of a faulty 
disk. Restart MS-DOS and try to RECOVER the disk. 
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DEVICE Support Not Present (DISKCOPY) 


The disk drive does not support MS-DOS Version 3.2 device 
control. 


Directory is totally empty, no. or .. 
The specified directory does not contain references to 
working and parent directories. Delete the specified directory 
and recreate it. 


Directory not empty (JOIN) 
You can only join onto a directory that is empty. 


Disk error (device error) 
An error has occurred reading from or writing to a disk. 
Attempt to correct the problem and reattempt this operation. 


Disk error reading FAT (CHKDSK) 
One of your File Allocation Tables (FAT) has a defective 
sector in it. MS-DOS will automatically use the other FAT. It 
is a good idea to copy all your files onto another disk. 


Disk error while reading drive A: 
Abort, Ignore, Retry? (DISKCOPY) 
DISKCOPY found errors during processing. 


Disk error writing FAT (CHKDSK) 
One of your File Allocation Tables (FAT) has a defective 
sector in it. MS-DOS will automatically use the other FAT. It 
is a good idea to copy all your files onto another disk. 


Disk unsuitable for system disk (FORMAT) 
This message is displayed when the /S option is specified 
with the FORMAT command to transfer the MS-DOS system 
files to the disk(ette) being formatted, and FORMAT detects 
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bad sectors in the system area on the disk(ette). If you were 
formatting a diskette, discard it and use another one. If you 
were formatting a fixed disk, use FDISK to delete the existing 
MS-DOS partition and create a new one at a different starting 
location on the disk. 


Disks must be the same size (DISKCOPY) 
You cannot copy the contents of a source disk with a format 
different from the target disk using DISKCOPY. Use the 
COPY command to copy files onto the disk. 


Do not specify filename(s) 

Command format: DISKCOMP d: d:[/1][/8] (DISKCOMP) 
You specified an incorrect switch or gave a filename in 
addition to a drive name. 


Do you see the leftmost 0? (Y/N) (MODE) 
MODE displays this message to help you align the test 
pattern on your screen. 


Do you see the rightmost 9? (Y/N) (MODE) 
MODE displays this message to help you align the test 
pattern on your screen. 


Does name specify a file name or directory name 

on the target (F = file D = directory)? (XCOPY) 
XCOPY displays this prompt if the target directory does not 
exist. 


DOS-DATA Partition cannot be the active 

partition. Select a DOS Partition (FDISK) 
You tried to make a DOS data partition active. This is not 
allowed. Enter the number of the MS-DOS or a non-DOS. 


partition. 
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Drive letter must be specified (FORMAT) 


You must specify the name of the drive that you want to 
FORMAT. 


Drive not ready (PRINT) 
If this message appears while PRINT attempts a disk access, 
PRINT keeps trying until the drive is ready. Any other error 
cancels the current file. In this case, an error message is 
printed on your printer. 


Drive types or diskette types not compatible 

(DISKCOMP) (DISKCOPY) 
You cannot compare a single-sided disk with a double-sided 
disk, or a high-density disk with a low-density disk. You 
should use FC to compare the files on the disks. 


Drive x: not ready 
Make sure a diskette is inserted into the drive 
and the door is closed (DISKCOMP) (DISKCOPY) 
The disk is not ready to be read from or written to. 


Duplicate file name or file not found (RENAME) 
An attempt has been made to rename a file with a filename 
that already exists on the target disk, or the file to be renamed 
could not be found on the specified disk drive. 


Enter current Volume Label for drive x: (FORMAT) 
FORMAT asks you to enter the current volume label for 
verification before it formats the fixed disk in the specified 
drive. 
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Enter new date: (DATE) 
You must respond to this prompt when you start MS-DOS. 
Enter the date in an mm-dd-yy format or press RETURN to 
accept the proposed date. 


Enter new time: (TIME) 
You must respond to this prompt when you start MS-DOS. 
Enter the time in an hh:mm format (where hh is hours and 
mm is minutes) or press RETURN to accept the proposed time. 


Entry has a bad attribute (or size or link) (CHKDSK) 
This message may be preceded by one or two periods to 
indicate which subdirectory is invalid. If you have specified 
the /F option, CHKDSK attempts to correct the error. 


Error loading operating system 
The ROM BIOS could not access the fixed disk. This is a 
hardware problem. Try rebooting one or more times by 
pressing the RESET button; or alternatively, try rebooting 
with the MS-DOS System Diskette in drive A. Contact your 
authorized AT&T dealer for assistance. 


Error reading hard disk 

Do you wish to change disks (Y/N)? (FDISK) 
There was a problem reading the partition table in the first 
sector of the first fixed disk. Contact your authorized AT&T 
dealer for assistance in correcting this problem. At this time, 
you may choose to change to your second fixed disk by 
entering y in response to the prompt. 
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Error reading hard disk 

Returning to DOS (FDISK) 
There was a problem reading the partition table in the first 
sector of your fixed disk. Contact your authorized AT&T 
dealer for assistance. 


Error reading/ writing partition table (FORMAT) 
FORMAT could not read or write the partition table. Run 
FDISK on the disk and then try formatting it again. 


Errors found, F parameter not specified 

Corrections will not be written to disk (CHKDSK) 
You must specify the /F option if you want the errors 
corrected by CHKDSK. 


Errors on list device indicate that it may be offline. Please 
check it. (PRINT) 
Your printer is turned off. 


FATAL: Internal Stacks Failure, System Halted (ROM) 
You entered CTRL-NUMLOCK (to stop the screen from 
scrolling) too many times in a row, exceeding the available 
stack resources and causing the system to crash. To prevent 
this from happening, increase the stack resources by 
including the following statement in your CONFIG.SYS file: 


stacks=64,128 


and reboot your system. 


Alternatively, you moved the Mouse 6300 in a sudden 
manner without having loaded the mouse driver in memory. 
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Reboot your system and at the MS-DOS prompt, change to 
the directory containing the mouse software and then type: 


mouse.com 


File cannot be converted (EXE2BIN) 
CS:IP does not meet either of the EXE2BIN criteria, or it meets 
the .COM file criterion but has segment fixups. This message 
is also displayed if the file is not a valid executable file or is 
not in the correct format. 


File cannot be copied into itself (COPY) (REPLACE) (XCOPY) 
The source filename you specified is the same as the target 
filename. A request was made to copy a file and place the 
copy (with the same name) in the same directory as the 
source file. Either change the name given to the copy or put 
it on another diskette or directory. 


File creation error (EXE2BIN) (XCOPY) 
The output file cannot be created. You tried to add a new 
filename or replace a file that already exists in the directory. 
If the file already exists, it is a read-only file and cannot be 
replaced. Run the CHKDSK program on the disk to 
determine the cause of the error. 


File input/output error (UNTAG/EXEC) 
UNTAG/EXEC could not access the tag list. Restart your 
computer and try again. 


File not found 
MS-DOS cannot find the file that you specified. Check to see 
that the name and pathname are accurate and that the file 
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exists in the directory on the disk. For RENAME, you tried to 
rename a file to a name already present in the directory. 


filename contains non-contiguous blocks (CHKDSK) 
The file or files you named are not written contiguously on 
the disk. 


filename file not found (PRINT) 
You switched disks while a file was in the print queue, but 
before it started to print. Reissue the PRINT command for 
that filename. 


filename is cross linked on cluster (CHKDSK) 
You have two files cross linked. Make a copy of the file you 
want to keep, and then delete both files that are cross linked. 


filename is currently being printed (PRINT) 
The filename specified is being printed. 


filename is in queue (PRINT) 
The filename specified is waiting to be printed. 


filename not in TAG list (UNTAG) 
You tried to untag a file that was not previously tagged. 
Check that you spelled the filename (and pathname, if 
specified) correctly. 


FIND: File not found filename (FIND) 
The file you specified does not exist on the drive. Check your 
filename entry or drive selection and try again. 


FIND: Invalid number of parameters (FIND) 
A string was omitted when specifying a FIND command. 
Re-enter the command with the search string. 
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FIND: Invalid parameter option-name (FIND) 
An invalid parameter was entered with the FIND command. 
Re-enter the command with a valid parameter. 


FIND: Read error in filename (FIND) 
An error occurred when FIND tried to read the file specified 
in the command. Reattempt the command after correcting an 
obvious problem (disk drive door open, no disk, etc.) Try to 
recover the file. 


FIND: Syntax error (FIND) 
You entered an illegal string with the FIND command. Re- 
enter the correct string which must be enclosed in quotation 
marks. 


First cluster number is invalid, entry truncated (CHKDSK) 
An invalid pointer to the data area has been found in the file 
whose name precedes this message. If /F was specified, the 
file is truncated to zero length. This is an irrecoverable error. 


FIRST diskette bad or incompatible (DISKCOMP) 
DISKCOMP cannot determine the format of the disk that you 
want to compare. 


Fixed disk already has a DOS partition (FDISK) 
You may have only one MS-DOS partition on a fixed disk. If 
you wish to change its size or location, you must delete the 
existing MS-DOS partition and create a new one. 


Fixed disk has maximum partitions (FDISK) 
FDISK allows you to create a maximum of four partitions, 
including MS-DOS, DOS data, and non-DOS partitions, on a 
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fixed disk. You must delete a partition before you can create 
another one. 


Fixups needed-base segment (hex): (EXE2BIN) 
The source (.EXE) file contained information indicating that a 
load segment is required for the file. Specify the absolute 
segment address at which the finished module is to be 
located. 


For cannot be nested (FOR) 
Nesting of FOR statements is illegal. 


Format another (Y/N)? (FORMAT) 
FORMAT displays this message when it has finished 
formatting the disk in the specified drive and is ready to 
format another disk with the same format. Press y to 
continue, and n to quit formatting. 


Warning: If you accidentally type y, all your data is 
destroyed. 


Format complete (FORMAT) 
FORMAT displays this message when it has finished 
formatting the disk in the specified drive. 


Format failure (FORMAT) 
MS-DOS could not format the disk. This message is usually 
displayed with an explanation as to why MS-DOS could not 
format the disk. 


Format not supported on drive x: (FORMAT) 
You cannot use FORMAT to format this drive. 


A-20 


Appendix A 
Messages 


Formatting while copying (DISKCOPY) 
If the target disk is not the same format as the source disk, 
DISKCOPY reformats the target disk. 


General failure error (device error) 
Some general problem exists with a device driver while 
attempting to read or write to the drive. 


Head: hh Cylinder: cc (FORMAT) 
FORMAT displays the current head and cylinder number 
before formatting it. 


HELP: argument is both a valid topic name and a valid 

category name. 

Enter a C or c if you want the category by this name, or 

enter a T or t if you want the topic(s) by this name, or 

press ESC to exit. (HELP) 
When you entered the HELP command, you specified a single 
argument which has been identified as both a valid category 
and valid topic. Enter c to display the index of topics for that 
Category. Enter t to display either the help text for that Topic 
or, if there is more than one occurrence of that topic, the 
index of categories with those categories containing the topic 
highlighted. Press ESC to return to DOS. 


HELP: argument is not a valid topic or category name. (HELP) 
When you entered the HELP command, you specified a single 
argument which cannot be identified as either a valid topic or 
category. Check that you spelled the argument correctly. The 
validity of a topic name is based on its first 14 characters, 
although you may use longer names for clarity. However, a 
category name must be 8 characters or less in length. 
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HELP: Default directory helpdir contains no valid (i.e., .CAT) 

category directories. (HELP) 
The default HELP directory is the directory containing the 
HELP.EXE program file. HELP searches this directory for 
subdirectories whose names end in .CAT, identifying them as 
categories of help, when the HELPDIRPATH environment 
variable is not set. Subdirectories which are intended as 
categories of help must be named in this way for HELP to 
identify them as such. Use the DIR command to check the 
directory containing the HELP.EXE file for .CAT 
subdirectories. If a subdirectory exists which you intended as 
a category of help but which you named incorrectly, use the 
MKDIR command to create a new subdirectory with a unique 
eight-or-fewer-character name plus a .CAT extension, copy 
the help files from the old subdirectory to the new one, and 
finally delete the help files from the old subdirectory and 
then the old subdirectory itself. 


HELP: get_category table - Insufficient memory available to 

store category table. (HELP) 
There was not enough memory to store the index of help 
categories. Terminate any applications that may be running 
in the background. If the error still occurs, or if you do not 
have any applications running in the background, reduce 
HELP’s memory requirements by copying some of the topic 
files in the specified category subdirectory to another category 
subdirectory and deleting them from the specified category 
subdirectory. As a last resort, you may be able to add more 
memory to your system. 
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HELP: get_topic_tbl - Insufficient memory available to begin 
topic table creation. (HELP) 
There was not enough memory to build the index of help 
topics for a specified help category. For the solution to this 
problem, see the error message: 


HELP: get_category_table - Insufficient memory 
available to store category table. (HELP) 


HELP: HELPDIRPATH directory helpdir contains no valid 

(i.e., .CAT) category directories. (HELP) 
HELPDIRPATH is the environment variable which you set, 
during installation of the Help facility, equal to the pathname 
of the help directory containing one or more help categories 
(subdirectories), each of which contains one or more help 
topics (files). If you do not specify the help directory path, 
then C:\HELPDIR is used. Categories of help must have 
subdirectory names ending in .CAT for HELP to identify 
them as such. For the solution to the problem of not having 
any .CAT subdirectories in your help directory, see the error 
message: 


HELP: Default directory helpdir contains no valid 
(i.e., .CAT) category directories. 


HELP: HELPDIRPATH is longer than 38 characters. (HELP) 
The path identifying the location of your help directory must 
be 38 or fewer characters long, including the drive specifier, 
if needed. In your AUTOEXEC.BAT file, include a SET 
command to set the HELPDIRPATH environment variable 
equal to a new path that meets this restriction, and use the 
XCOPY command with the /S option to copy the help 
category subdirectories and their help topic files from the old 
help directory to the new one. Reboot your system and try 
using help again. 
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HELP: Neither category category name nor topic topic name 
found. (HELP) 
The help category name and help topic name you specified as 
arguments to the HELP command could not be found in your 
help directory. Check that you spelled both names correctly; 
also check that the corresponding subdirectory and file exist. 


HELP: No more than two arguments allowed. (HELP) 
You specified more than the maximum of two arguments 
allowed for the HELP command. Re-enter the HELP 
command, specifying no arguments, one argument (either a 
valid help category name or a valid help topic name), or two 
arguments (the first of which must be a category and the 
second a topic). 


HELP: remake_topic_tbl - Insufficient memory available to 
complete topic table. (HELP) 
There was not enough memory to build the index of help 
topics for a specified help category. For the solution to this 
problem, see the error message: 


HELP: get_category_table - Insufficient memory 
available to store category table. (HELP) 


HELP: There are no categories in helpdir (HELP) 
The help directory exists but does not contain any help 
category subdirectories. See Installing Help in Chapter 7 for 
information on how to install the AT&T-provided DOS.CAT 
subdirectory and its help topic files, and/or Customizing 
Help also in Chapter 7 for information on how to add other 
help category subdirectories in your help directory. 
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HELP: There are no topics in category name. (HELP) 
The specified help category subdirectory exists but does not 
contain any help topic files. See Customizing Help in 
Chapter 7 for information on how to create help topic files. 


HELP: toc_to_tbl - Insufficient memory available to complete 
topic table. (HELP) 
There was not enough memory to build the index of help 
topics for a specified help category. For the solution to this 
problem, see the error message: 


HELP: get_category_table - Insufficient memory 
available to store category table. (HELP) 


Illegal device name (MODE) 
Your computer does not recognize this device name. 


Illegal option (TAG/UNTAG) 
You specified an illegal option for the TAG/UNTAG 
command. /S—tag/untag files matching the filename 
argument in the specified or current directory(ies) and their 
subdirectories—is the only valid option you may specify. 


Illegal path (TAG/UNTAG/EXEC) 
The path(s) you specified does not exist. Check that you 
spelled the path(s) correctly; also check that all subdirectories 
specified in the path(s) exist. 


Incompatible system size (SYS) 
The hidden files IBMBIO.COM and IBMDOS.COM do not 
take up the same amount of space on the target diskette as the 
new system needs. Use the same version of MS-DOS to move 
these files. 
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Incorrect DOS version (CHKDSK) (DISKCOMP) (DISKCOPY) 
(FORMAT) (FIND) (TREE) (XCOPY) 
You must use the correct version of MS-DOS with these 
commands. You cannot run CHKDSK on versions of MS-DOS 
before 3.0. You cannot use FORMAT with an earlier version 
of MS-DOS. FIND will only run on versions of MS-DOS that 
are 2.0 or higher. 


Incorrect number of parameters (JOIN) (SUBST) 
You specified too many or too few options in the command. 


Incorrect parameter (ASSIGN) (SHARE) 
One of the options you specified is wrong. 


Infinite retry on parallel printer timeout (MODE) 
Your printer is probably off-line or not ready. If the printer 
appears to be ready, you should press CTRL, ALT, and 
DEL to reset the computer. 


Insert disk with COMMAND.COM in drive a: 

press the RETURN key when ready (EXEC) 
The COMMAND.COM file was needed to perform the 
MS-DOS command specified as an argument to the EXEC 
command, but could not be found. Insert the MS-DOS System 
Diskette in drive A and press RETURN when ready. 


Insert diskette for drive x: and strike 

ENTER when ready (FORMAT) 
You should insert a disk in the appropriate drive and press 
RETURN to begin formatting. 
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Insert DOS diskette in drive x: and strike 

ENTER when ready (FORMAT) 
You have specified "format /s" but the disk in the default 
drive does not contain MS-DOS system files. Insert your 
MS-DOS master disk copy in the drive specified and press 
RETURN. 


Insert FIRST diskette in drive x: 

Press any key when ready . . . (DISKCOPY) 
DISKCOPY displays this message to prompt you to insert the 
first disk into the specified drive. 


Insert formatted target diskette into drive x: (DISKCOPY) 
The DISKCOPY program is ready for a disk in the destination 
drive. The DISKCOPY program requires that the destination 
disk be already formatted. 


Insert new diskette for drive x: 

and strike ENTER when ready (FORMAT) 
This message appears when you are using a single drive to 
format a disk. You should insert a disk in the appropriate 
drive and press RETURN to begin formatting. If there is any 
data on the disk, FORMAT will destroy it. Press CTRL-C if 
you do not want to format the disk. 


Insert SECOND diskette in drive x: 

Press any key when ready... (DISKCOPY) 
DISKCOPY displays this message to prompt you to insert the 
second disk into the specified drive. 


Insert source diskette in drive D: 
Press any key when ready... (DISKCOPY) 
This is the prompt to begin the DISKCOPY process. 
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Insert source diskette into drive x: 
Insert the disk to be copied into the specified drive. 


Insert system disk (FORMAT) 
You are formatting a disk with the /S option. You must place 
a disk with the system files in the disk drive before the 
format program can continue. 


Insert target diskette in drive D: 
Press any key when ready... (DISKCOPY) 
This is the prompt to begin the DISKCOPY process. 


Insert target diskette into drive x: (DISKCOPY) 
You are running the DISKCOPY program and your source 
and target drives are the same. Reinsert the target disk into 
the specified drive. 


INSTLDOS: Cannot get fixed disk parameters. (INSTLDOS) 
INSTLDOS could not read the partition table at the beginning 
of your fixed disk. Your fixed disk may not be installed 
properly. Contact your authorized AT&T dealer for 
assistance. 


INSTLDOS: Cannot get memory space for boot sector data. 

(INSTLDOS) 
There was not enough memory for INSTLDOS to store the 
information from the boot sector of the active partition on 
your fixed disk. Terminate any applications that may be 
running in the background, reboot your system with the 
MS-DOS Version 3.2 System Diskette in drive A, and restart 
the INSTLDOS program. If the problem still occurs, you may 
need to add more memory to your system. 
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INSTLDOS: Cannot get memory space for disk parameters. 
(INSTLDOS) 
There was not enough memory for INSTLDOS to store the 
information from the partition table at the beginning of your 
fixed disk. For the solution to this problem, see the error 
message: 


INSTLDOS: Cannot get memory space for boot sector 
data. (INSTLDOS) 


INSTLDOS: Cannot get memory space for partition sector data. 
(INSTLDOS) 
There was not enough memory for INSTLDOS to store 
information from the active partition on your fixed disk. For 
the solution to this problem, see the error message: 


INSTLDOS: Cannot get memory space for boot sector 
data. (INSTLDOS) 


INSTLDOS: Cannot read disk parameters. (INSTLDOS) 
INSTLDOS could not read the boot sector of the active 
partition on your fixed disk. Your fixed disk may not be 
installed properly. Contact your authorized AT&T dealer for 
assistance. 


INSTLDOS: Could not create autoexec.bat file. (INSTLDOS) 
There was not enough room on your fixed disk for 
INSTLDOS to store a newly created AUTOEXEC.BAT file. 
Reboot your system with the MS-DOS Version 3.2 System 
Diskette in drive A and use the DIR command to check the 
amount of free space on your fixed disk. If necessary, use the 
COPY command to copy some files to one or more diskettes 
and the DEL command to delete them from the fixed disk. 
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INSTLDOS: Could not open renamed autoexec.bat file. 
(INSTLDOS) 
There was not enough room on your fixed disk for 
INSTLDOS to store a temporary copy of your 
AUTOEXEC.BAT file. For the solution to this problem, see 
the error message: 


INSTLDOS: Could not create autoexec.bat file. 
(INSTLDOS) 


INSTLDOS: Failure partitioning drive C. (INSTLDOS) 
INSTLDOS could not write the partition table at the 
beginning of your fixed disk. Either your fixed disk is not 
installed properly, or there are bad sectors on that part of the 
disk, making it unusable. Contact your authorized AT&T 
dealer for assistance. 


INSTLDOS: You must boot from the MS-DOS 3.2 System 
Diskette. (INSTLDOS) 
You were using a version of MS-DOS earlier than 3.2 when 
you began the INSTLDOS program, and/or the boot drive 
was not drive A. Restart your computer with the MS-DOS 
Version 3.2 System Diskette in drive A and enter INSTLDOS 
at the MS-DOS prompt. 


Insufficient disk space (EXE2BIN) (REPLACE) (TAG/UNTAG) 
For EXE2BIN, there is not enough disk space to create a new 
file. For REPLACE, there is not enough room on the target 
disk for the replace operation. For TAG/UNTAG, there was 
not enough room on your default disk to merge/remove the 
files you want to tag/untag with/from the list of previously 
tagged files (if any) on disk. To free up space on your disk, 
copy several files to another disk(ette) and delete them from 
the default disk. 
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Insufficient memory (DISKCOMP) (DISKCOPY) (EXE2BIN) 

(REPLACE) (TAG/EXEC) 
For DISKCOMP, there is not enough memory available to 
perform the comparison. For DISKCOPY, there is not enough 
memory to do the copy. For EXE2BIN and REPLACE, there is 
not enough memory to run them. For TAG/EXEC, there was 
not enough memory to merge the files you want to tag with 
the list of previously tagged files (if any) on disk, or to EXEC 
the specified MS-DOS command on the tagged files. Eliminate 
any applications that may be running in the background. If 
the error still occurs, or if you do not have any applications 
running in the background, try tagging fewer files or 
untagging previously tagged files. As a last resort, add more 
memory (chips) to your machine. 


Insufficient memory for system transfer (FORMAT) 
Your memory configuration is insufficient to transfer the 
MS-DOS system files IO.SYS and MS-DOS.SYS with the /S 
option. 


Insufficient memory 

Processing cannot continue (CHKDSK) 
There is not enough memory in your machine for CHKDSK 
to process this disk. You must obtain more memory to run 
CHKDSK. 


Insufficient room in root directory 

Erase files in root and repeat CHKDSK (CHKDSK) 
CHKDSK cannot create an entry in the root directory for 
saving lost chains as files because the root directory if full. 
See the message: 


n lost clusters found in m chains 
Convert lost chains to files [Y/N?] 
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You should copy some files from the root directory to another 
disk, then enter another CHKDSK command. 


Invalid baud rate specified (MODE) 
You have specified an incorrect baud rate. Valid choices are 
110, 150, 300, 600, 1200, 2400, 4800, and 9600. You must 
specify at least the first two digits of the baud rate. 


Invalid characters in volume label (FORMAT) 
The volume label should contain only up to 11 alphanumeric 
characters. 


Invalid characters in volume label 
Volume label (11 characters, ENTER for none)? (LABEL) 
You cannot use the characters: 


S21 Neg pe t= <> ]] 


or the tab character in a volume label. Re-enter the volume 
label. 


Invalid COMMAND.COM. Insert disk with 

COMMAND.COM 

in drive x: and strike any key when ready 
The application you have just run used up almost all of 
memory. It is necessary for MS-DOS to reload the 
COMMAND.COM file from disk. However, MS-DOS cannot 
find COMMAND.COM on the disk or the copy found is 
invalid. Insert a disk into the specified drive which contains 
a copy of COMMAND.COM similar to the version on the disk 
with which you started MS-DOS. 
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Invalid current directory 

Processing cannot continue (CHKDSK) 
CHKDSK has found an error in the disk’s current directory. 
Restart your computer and rerun CHKDSK. 


Invalid date 

Enter new date (mm-dd-yy):_ (DATE) (XCOPY) 
If the numbers or separators are not valid, DATE displays this 
message. Enter a valid date. See Chapter 5 for the DATE 
command format. 


Invalid device parameters from device driver (FORMAT) 
Format displays this message when the number of hidden 
sectors is not evenly divisible by the number of sectors per 
track (that is, the partition does not start on a track 
boundary). This might happen if you tried to format a fixed 
disk that previously had been formatted with MS-DOS 
Version 2.x without first ranning FDISK. 


Invalid drive specification (CHKDSK) (DISKCOMP) (FORMAT) 
(LABEL) (TREE) (XCOPY) 
You specified a drive that is incorrect or does not exist. 
Specify a valid drive. For LABEL, you cannot label a drive 
that is not logically assigned. 


Invalid drive specification 
Specified drive does not exist or is non-removable (DISKCOPY) 
You specified an invalid or nonremovable drive. 


Invalid drive specification x: (REPLACE) 
Drive x does not exist. 
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Invalid media or Track 0 bad - disk unusable (FORMAT) 
In processing, FORMAT detected bad sectors at the beginning 
of the diskette being formatted. For solutions to this problem, 
see the error message: 


Disk unsuitable for system disk (FORMAT) 


Invalid number of parameters (XCOPY) 
You have entered the wrong number of parameters on the 
command line. Refer to the syntax of the command you have 
selected and try again. 


Invalid parameter (CHKDSK) (DISKCOMP) (FORMAT) 
(REPLACE) (TREE) (XCOPY) 
You specified a switch or a parameter that is incorrect or does 
not exist. For TREE, the /F option is the only valid 
parameter. 


Invalid parameter, 
Do not specify filename(s) 
Command Format: DISKCOPY (x:) (x:) [/1] (DISKCOPY) 
You specified either an illegal switch or filenames instead of 
only drive names. 


Invalid partition table 
Either no partition or multiple partitions have been made 
active, so that the partition from which to boot cannot be 
determined. Run FDISK and make one and only one partition 
active, selecting either the MS-DOS partition, or a non-DOS 
partition, but not a DOS data partition. As an alternative, try 
rebooting with the MS-DOS System Diskette in drive A. 
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Invalid path (TREE) (XCOPY) 
The source path described a nonexistent subdirectory or the 
Path is invalid. 


Invalid subdirectory (CHKDSK) 
The subdirectory contains invalid information. Rerun the 
CHKDSK command with the /V option for further 
information. 


Invalid time (TIME) 
You have entered an invalid time or the wrong punctuation 
mark. Refer to the TIME command syntax and try again. 


Invalid Volume ID (FORMAT) 
FORMAT displays this message if you enter a volume label 
that does not match the label on the fixed disk you want to 
format. It then quits the format process. 


Invalid working directory 

Processing cannot continue (CHKDSK) 
Your disk is bad. Replace the disk or make a copy from your 
back-up system disk. 


List output is not assigned to a device (PRINT) 
You have specified an invalid device. Specify a valid list 
device. When you first type the PRINT command, MS-DOS 
asks you what device you want to specify as a printer. This 
message appears only if the PRINT program is set up for a 
nonexistent device. 


LPT#: not redirected (MODE) 
The status of LPT# is unredirected. Check to see that you 
have specified the proper options if you wanted to redirect 
this LPT device to a COM device. 
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LPT#: redirected to COM#: (MODE) 


Output on the parallel printer port will now be sent to this 
asynchronous communications port. 


LPT#: set for 80 (MODE) 


The parallel printer port has been set for 80 columns. 


LPT#: set for 132 (MODE) 


The parallel printer port has been set for 132 columns. 


Missing operating system 


An error occurred in reading the boot sector of the active 
partition of the disk from which you are trying to boot. Use 
the BACKUP command to back up all files (if any) from the 
fixed disk to back-up diskettes, then use the FORMAT 
command with the /S option to reformat the fixed disk and 
transfer the system files to it, and finally use the RESTORE 
command to restore the back-up files to the fixed disk. As an 
alternative, try rebooting with the MS-DOS System Diskette 
in drive A. 


n lost clusters found in m chains 
Convert lost chains to files (Y/N)? (CHKDSK) 


If you respond y to this prompt, and if you specified the /F 
option, CHKDSK creates a file in the root directory for you to 
resolve this problem (files created by CHKDSK are named 
FILEnnnn.CHK). If you did not specify the /F option, 
CHKDSK does nothing. 


If you respond n to this prompt and have specified the /F 
option, CHKDSK displays: 


x bytes disk space freed 
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If you respond n to this prompt and have not specified the /F 
option, CHKDSK displays: 


x bytes disk space would be freed 


nnnn of nnnn bytes recovered (RECOVER) 
This message tells you the number of bytes that MS-DOS was 
able to recover from the disk. 


Name of list device [PRN:] (PRINT) 
This prompt appears when PRINT is run the first time and 
the /D option is not specified. Any current device may be 
specified and that device then becomes the PRINT output 
device. As shown in the brackets, you can press RETURN so 
that MS-DOS uses the default list device (PRN). 


Need DOS Version 3.00 or later. (HELP) 
You were using a version of MS-DOS earlier than 3.0 when 
you entered the HELP command. Restart your computer with 
the MS-DOS Version 3.0 (or later) System Diskette in drive A 
and try again. 


Need MS-DOS 3.0 or greater (TAG/ UNTAG/EXEC) 
You were using a version of MS-DOS earlier than 3.0 when 
you entered the TAG/UNTAG/EXEC command. Restart your 
computer with the MS-DOS Version 3.0 (or later) System 
Diskette in drive A and try again. 


No COM: ports (MODE) 
Your computer does not have a COM: port. 


No DOS-DATA Partition to delete (FDISK) 
You tried to delete a DOS data partition when none existed. 
Press ESC to return to the FDISK main menu. 
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No DOS partition to delete (FDISK) 
You tried to delete an MS-DOS partition when none existed. 
Press ESC to return to the FDISK main menu. 


No files added/replaced (REPLACE) 
The REPLACE command did not add or replace any files. 


No files added to tag list (TAG) 
You tried to tag one or more files that could not be found. 
Check that you spelled the filename(s) correctly and that the 
pathname(s) (if specified) exists. Also check that the 
requested file(s) either is in your current directory or can be 
located using the current PATH or APPEND environment 
variable. Alternatively, you may have specified the /S option 
for the TAG command without specifying an argument. You 
must specify either a pathname or filename argument or both 
to use the /S option. 


No files found filename (REPLACE) 
REPLACE could not find matching source or target files. 


No files match filename (PRINT) 
You have entered a file specification for files to add to the 
print queue, but no files match your entry. Check your 
filenames and try again. 


Note: If there are no files in the print queue, a message 
does not appear. 


No fixed disks present (FDISK) 
The ROM BIOS could not detect the presence of any fixed 
disks. If you have one or more fixed disks on your system, 


No 


No 


No 


No 
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certain options may not be set correctly. Contact your 
authorized AT&T dealer for assistance. 


Paper error (device error) 
Your printer is not powered ON or it is out of paper. Check 
your printer and try again. 


partitions defined (FDISK) 

This message is displayed either before you create the first 
partition on your fixed disk or when you try to change the 
active partition or delete a partition and no partitions exist on 
your fixed disk. In the first case, this is simply a status 
message; in the last two cases, this is an error message 
indicating that you must create a partition before you can 
make one active or delete one. 


partitions to make active (FDISK) 
This error message is displayed along with the message: 


No partitions defined (FDISK) 


path (PATH) 
You typed PATH with no options but have not set a 
command search path. 


room for system on destination disk (SYS) 

There is not enough room on the target diskette for the 
IBMBIO.COM and IBMDOS.COM files. You are using 
different versions of MS-DOS. Use the same version for this 
operation. 


space for a DOS/DOS DATA partition (FDISK) 
All space on your fixed disk has been allocated previously to 
other partitions. If you wish to create a new MS-DOS or DOS 
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data partition, you must delete one of the existing partitions 
first. 


No space for a number of cylinders cylinder partition 

at cylinder starting cylinder number (FDISK) 
The size of the partition you requested is too large to fit on 
your fixed disk starting at the cylinder you specified because 
it would either overlap a succeeding partition or exceed the 
end of the disk. Enter a different partition size and starting 
cylinder number in response to the prompts. 


No subdirectories exist (TREE) 
The disk in the drive you specified does not contain 
subdirectories. 


No text for topic fopic_name (HELP) 
The specified help topic file exists but does not contain any 
help text. See Customizing Help in Chapter 7 for information 
on how to create the text for a help topic file. 


Non MS-DOS disk error (device error) 
The file allocation table on the diskette contains invalid 
information. If you have inserted the correct diskette, it must 
be reformatted. Attempt to copy important files from this 
diskette to another before you format this diskette. 


Non-System disk or disk error 

Replace and hit any key 
An error occurred in reading the directory sector of the active 
partition of the disk from which you are trying to boot. Check 
that the disk is an MS-DOS system or otherwise bootable disk, 
that is, check that the system files IBMBIO.COM and 
JIBMDOS.COM are the first two files on the disk. To view 
them with the DIR command, you may have to "unhide" them 
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first using the CHMOD command. If these files exist in the 
required location and the error still occurs, try using the SYS 
command to transfer these files from the MS-DOS System 
Diskette to the fixed disk from which you are trying to boot. 
If SYS fails, use the BACKUP command to back up all files (if 
any) from the fixed disk to back-up diskettes. Then, use the 
FORMAT command with the /S option to reformat the fixed 
disk and transfer the system files to it. Finally, use the 
RESTORE command to restore the back-up files to the fixed 
disk. If all approaches fail, it may be an indication of a 
hardware problem; contact your authorized AT&T dealer for 
assistance. 


Not enough memory 
There is not enough memory for MS-DOS to run the 
command. 


Not ready error (device error) 
The device you've selected is not ready for the read/write 
operation you've requested. Check the device and try again. 


number is not a choice. Enter a choice. (FDISK) 
In designating the partition you wished to make active, you 
specified a number other than one that corresponds to an 
existing partition. Enter a valid partition number. 


Out of environment space 
Your environment does not have sufficient space for the 
number of characters you have attempted to store. Use the 
SHELL command with the /E option in your CONFIG.SYS 
file to expand the environment space. 


Parameters not compatible (FORMAT) (REPLACE) 
You have specified switches that are mutually exclusive. 


Appendix A 
Messages 


Parameters not compatible with fixed disk (FORMAT) 
You have used a switch that is not compatible with the 
specified drive. 


Parameters not supported (FORMAT) 
You have specified parameters that MS-DOS does not support. 


Parameters not supported by Drive (FORMAT) 
FORMAT displays this message when the device driver for 
this drive does not support Generic IOCTL function requests. 


Partition 0 is not a valid choice 

Select a valid DOS-DATA Partition (FDISK) 
In designating the DOS data partition you wanted to delete, 
you specified the number 0. This number is not used to 
designate any partition. Enter the number of a DOS data 
partition. 


Partition 1 is already active (FDISK) 
MS-DOS is your only existing partition and you tried to make 
it active when it was active already. If you want to make a 
non-DOS partition active, you must use the equivalent of the 
FDISK utility for that operating system to create a partition 
for it first. 


Partition number is not a DOS-DATA Partition 

Select a DOS-DATA Partition (FDISK) 
In designating the DOS data partition you wanted to delete, 
you specified a number that does not correspond to a DOS 
data partition. Enter the number of a DOS data partition. 


Path not found path (REPLACE) 
The source or target path did not exist. 


Appendix A 
Messages 


—qq—j]\Ra jum 


Path too long (REPLACE) (XCOPY) 
The pathname you specified was too Jong. You may have to 
change directories to replace files in deep subdirectories. 


Press any key to begin adding files (REPLACE) 
When you specify the /W option, REPLACE displays this 
message to prompt you to start replacing files. 


Press any key when ready 
This prompt occurs when you are copying disks. When you 
have inserted the disks into the appropriate drives, press the 
SPACE bar to begin the DISKCOPY program. If you wish to 
discontinue this operation, press CTRL-S. 


Press ENTER when ready 
This prompt is issued before you format a disk. Press 
RETURN to begin the format process. If you wish to 
discontinue this operation, press CTRL-C. 


PRINT queue is empty (PRINT) 
There are no files in the print queue. Files must be placed in 
the print queue before they can be printed. 


PRINT queue is full (PRINT) 
The default limit for the print queue is 10 files. You can set a 
larger number by using the /Q option when you type the 
PRINT command. The maximum number you can set is 32 
(minimum is 4) when using the /Q option. 


Printer lines per inch set (MODE) 
Mode has set the number of lines per inch for the printer. 
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Probable non-MS-DOS disk 
Continue (Y/N)? (CHKDSK) 


Pro: 


The disk you are using is a non-MS-DOS system diskette. 
Indicate whether or not you want CHKDSK to continue. This 
error message usually means that the File Allocation Table 
(FAT) is bad. 


gram too big to fit in memory 

You must acquire more memory to run your application. It is 
possible that some applications you have run are still using 
some memory. You may try to restart MS-DOS; however, if 
you still receive this message, you must acquire more 
memory. 


RAMDrive: Above Board Memory Manager not present 
(RAMDRIVE) ~ 


You specified the /A option with the RAMdrive device 
driver, indicating that the RAMdrive should be built in 
expanded memory. However, AT&T’s Expanded Memory 
Manager software driver, AEMM.SYS, could not be found. 
Check that the statement device=aemm.sys appears in your 
CONFIG.SYS file ahead of any device=ramdrive.sys 
statements. Also check that the aemm.sys file resides on the 
disk from which you are booting. 


RAMDrive: Above Board Memory Status shows error 
(RAMDRIVE) 


AT&T's Expanded Memory Manager software driver detected 
an error in the memory on the AT&T Enhanced Memory 
Expansion Board. The RAMdrive may or may not be built, 
depending on the size you specified and the amount of error- 
free memory on the board. To eliminate the problem, replace 
the memory chips on the board with new ones. 
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RAMDrive: Incorrect DOS Version (RAMDRIVE) 
You must use MS-DOS Version 3.2 to use the RAMDRIVE 
device driver. Reboot your system from a disk containing this 
version of MS-DOS. 


RAMDrive: Insufficient memory (RAMDRIVE) 
There was not enough conventional memory to accommodate 
the size RAMdrive you specified. Either edit the 
device=ramdrive.sys statement in your CONFIG.SYS file, 
specifying a smaller RAMdrive size (that is, the bbbb 
argument, in kilobytes—the default value is 64, the minimum 
value is 16, and the maximum is 4,096, that is, 4 Mb), or 
specify the /A option to build the RAMdrive in expanded 
memory on an AT&T PC 6300, or the /E or /U option to build 
the RAMdrive in extended or upper extended memory, 
respectively, on an AT&T PC 6300 PLUS. 


RAMDrive: Invalid parameter (RAMDRIVE) 
Either you specified the /U option to build a RAMdrive in 
upper-extended memory on an AT&T PC 6300, which does 
not support upper-extended memory (only the AT&T PC 6300 
PLUS supports upper-extended memory), or you specified a 
RAMadrive option that does not exist. Edit the 
device=ramdrive.sys statement in your CONFIG.SYS file, 
specifying instead either /A for expanded memory or no 
option for conventional memory, and reboot your system. 


RAMDrive: I/O error accessing drive memory (RAMDRIVE) 
The system could not read from or write to a RAMdrive. This 
problem is usually due to bad memory at that location. While 
the information in your RAMdrive is likely lost, you may be 
able to save some of it by copying the contents of your 
RAMadrive to a fixed disk or diskette. 
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RAMDrive: No extended memory available (RAMDRIVE) 
You specified the /E option to build a RAMdrive in extended 
memory on an AT&T PC 6300, which does not support 
extended memory. (Only the AT&T PC 6300 PLUS and 
compatible machines support extended memory.) Edit the 
device=ramdrive.sys statement in your CONFIG.SYS file, 
specifying instead either /A for expanded memory or no 
option for conventional memory, and reboot your system. 


Read error in filename (commands) 
The command you've entered could not read the entire file. 
Try again. If the problem persists, try to recover the file. 


Read fault error (device error) 
MS-DOS cannot read the requested data from the named 
device. Check your entry and try again. 


Reading source file(s)... (XCOPY) 
XCOPY is now reading the source files that you specified. 


Re-insert diskette for drive x: (FORMAT) 
FORMAT displays this message after it has read in system 
files from another disk. 


Resident part of Print installed (PRINT) 
This is the first message that MS-DOS displays when you 
issue the PRINT command. It means that available memory 
has been reduced by several thousand bytes to process PRINT 
along with other processes. 


Resident portion of MODE loaded (MODE) 
Part of the MODE program is now resident in memory. 
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SECOND diskette bad or incompatible (DISKCOMP) 
The second disk does not contain the same format as the first 
disk, or DISKCOMP does not recognize the format of the 
second disk. 


Sector not found error (device error) 
The sector containing the requested data cannot be found or 
cannot be read. This is usually due to a bad sector on the 
diskette or disk. Try to recover the diskette. If this does not 
solve the problem, the data is lost. 


Seek error (device error) 
The diskette drive cannot find the proper track on the 
diskette. Try again. If the problem persists, the diskette is 
probably damaged and cannot be recovered. 


Share Already Installed (SHARE) 
You can install SHARE only once. 


Source and target diskettes are not the same format. 

Cannot do the copy (DISKCOPY) 
You must have the same size and kind of disks to run the 
DISKCOPY program. Example: you cannot copy from a 
single-sided disk to a double-sided disk. Reformat the target 
disk to be of the same type as the source disk, or use the 
COPY command to copy the files. 


Source path required (REPLACE) 
You did not specify a source path for REPLACE. 


Source diskette bad or incompatible 
Copy process ended (DISKCOPY) 
DISKCOPY could not read the source diskette. 
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Specified drive does not exist or is non-removable (DISKCOMP) 
You must specify the name of a valid diskette drive. 
DISKCOMP cannot compare fixed disks. 


Specified partition size too large (FDISK) 
You specified a partition size that exceeds either the largest 
available contiguous space on disk or 32 Mb, whichever is 
smaller. FDISK allows you to create a partition up to 32 Mb in 
size, provided there is enough uninterrupted space for it on 
the disk. Enter a smaller number of cylinders in response to 
the prompt for a partition size. 


Specified starting cylinder already allocated to another 
partition (FDISK) 
As stated. Enter a different partition size and starting cylinder 
number in response to the prompts. 


Strike any key when ready... 
This prompt occurs during command processing and is always 
accompanied by another message. Usually, you are asked to 
insert disks into appropriate drives before this prompt. Press 
RETURN to begin command processing. 


Subdirectory containing tag list is full (EXEC) 
In processing, EXEC exceeded the maximum number of 
entries allowed by MS-DOS in a subdirectory, specifically the 
subdirectory containing the tag list. To free up space in this 
subdirectory, copy a few files to another subdirectory and 
delete them from the subdirectory containing the tag list. 
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Syntax error 

Arguments expected (EXEC) 
You entered the EXEC command without an argument. You 
Beer another MS-DOS command as an argument to 


System transferred (FORMAT) 
The system files have been transferred during FORMAT 
processing. 


Tag list is empty (UNTAG/EXEC) 
Either no files were currently tagged, or the tag list could not 
be found. Check that the tag list either is in the directory 
containing the TAG.EXE file or can be located using the 
PATH environment variable. 


Target diskette bad or incompatible 
Copy process ended (DISKCOPY) 
The target diskette could not be read or formatted. 


Target diskette is write-protected (DISKCOPY) 
The target disk has a write-protect tab on it. 


Target diskette may be unusable (DISKCOPY) 
Unrecoverable read or write errors were encountered while 
copying to the target disk. The target disk is not an exact 
copy of the source disk. 


The command exceeds the maximum length (EXEC) 
You specified an EXEC command containing more than the 
maximum 128 characters (including blanks) allowed by 
MS-DOS. Either change directories so that you can specify 
shorter pathname(s), or specify fewer options. 


AAD 
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Track 0 bad - disk unusable (FORMAT) 
FORMAT can accommodate for defective sectors on the disk 
except for those near the beginning. In this case, use another 
disk. This message can also occur when you are formatting 
high-density media either with the FORMAT /4 switch or in 
a standard-density drive. 


Unable to create directory (MKDIR) (XCOPY) 
MS-DOS could not create the directory you specified. Check 
to see that there is not a name conflict. You may have a file 
by the same name, or the disk may be full. 


Unable to shift Screen (MODE) 
MODE is unable to shift the test pattern on the screen any 
farther. 


Unexpected DOS Error nnn (REPLACE) 
An unexpected error occurred, where nnn is the MS-DOS 
error number. 


Unrecoverable error in directory 
Convert directory to file (Y/N)? (CHKDSK) 
To convert the problem directory to a file, type: 


bé 


You can then repair or delete the directory at a later time. If 
you respond n to this prompt, you may not be able to write or 
to read from the bad directory. 


Unrecoverable read error on drive x: (DISKCOMP) 
DISKCOMP could not read the disk. 
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Unrecoverable readjurite error on drive x: 
side nn, track nn (DISKCOPY) 
An error reading /writing to the disk occurred. 


Volume in drive x: has no label (VOL) 
This is an informational message displayed in response to the 
DIR command. The disk in the drive does not have a volume 
label. 


Volume in drive x: is filename 
This is an informational message displayed in response to the 
DIR command. 


Volume label (11 characters, ENTER for none)? (FORMAT) 
This message appears in response to the FORMAT /V option. 
Specify a volume label or press RETURN to indicate that you 
do not want a volume label for this disk. 


WARNING, ALL DATA ON NON-REMOVABLE DISK 
DRIVE x: WILL BE LOST! 
Proceed with Format (Y/N)? (FORMAT) 
There is data on the fixed disk you are trying to format. If 
you want to lose the data and format the disk, type: 


y 


If you do not want the files on your disk erased, type: 


and copy the files onto diskettes and repeat the FORMAT 
command. 
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Warning - directory full (RECOVER) 
The root directory is too full for RECOVER processing. 
Delete some files in the root directory to free space. 


WARNING - Read error in EXE file. 

Amount read less than size in header (EXE2BIN) 
This is a warning message only. It means that the .EXE 
header in the file is inconsistent with the size of the file. 


Write fault error (device error) 
MS-DOS cannot successfully write data from or to the named 
device. Check your entry and try again. 


Write protect error (device error) 
You have tried to write data onto a diskette that is write- 
protected. Check the diskette to be sure that you want to 
write to or change information on this diskette. 
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(W)rite 


Messages 
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Introduction 


ee 


This appendix is a function and command reference to the EDLIN 
Program on your MS-DOS System Diskette. EDLIN is provided 
for use by persons with prior experience in programming 
computers. EDLIN is not intended for novice users. If you are 
new to using computers, you will find that a dedicated word 
processing program may be easier to use. The information in this 
appendix does not include a tutorial for use by beginners. 


If you are an experienced computer user you may choose to use 
EDLIN to create, change, and display files, whether they are 
source program or text files. 


You can use EDLIN to: 


* Create new source files and save them 


° Update existing files and save both the updated and 
original 


* Delete, edit, insert, and display lines 


© Search for, delete, or replace text within one or more lines. 


The text in files created or edited by EDLIN is divided into lines, 
each up to 253 characters long. Line numbers are generated and 
displayed by EDLIN during the editing process, but are not 
actually present in the saved file. 


When you insert lines, all line numbers following the inserted 
text advance automatically by the number of lines being inserted. 
When you delete lines in a file, all line numbers following the 
deleted text decrease automatically by the number of lines 
deleted. As a result, lines are always numbered consecutively in 
your file. 
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EDLIN commands perform editing functions on lines of text. The 
following list contains information you should read before you 
use EDLIN commands. 


© Pathnames are acceptable as options to commands. For 
example, typing: 


edlin \bin\user\joe\text.txt 


allows you to edit the TEXT.TXT file in the subdirectory 
\JOE. 


You can reference line numbers relative to the current line 
(the line with the asterisk). Use a minus sign with a 
number to indicate lines before the current line. Use a 
plus sign with a number to indicate lines after the current 
line. For example, the command: 


—10,+10L 


lists 10 lines before the current line, the current line, and 
10 lines after the current line. 


Multiple commands may be issued on one command line. 
When you issue a command to edit a single line using a 
line number (line), a semicolon must separate commands 
on the line. Otherwise, one command may follow another 
without any special separators. For example, the following 
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command line edits line 15 and then displays lines 10 
through 20 on the screen. 


15;-5,+5L 


In the case of a Search or Replace command, the string 
may be ended by a CTRL-Z instead of a RETURN. The 
command line in the example below searches for "this 
string” and then displays 5 lines before and 5 lines after 
the line containing the matched string. If the search fails, 
then the displayed lines are those line numbers relative to 
the current line. 


this string CTRL-Z —5,+5L 


You can type EDLIN commands with or without a space 
between the line number and command. For example, to 
delete line 6, the command 6 d is the same as 6d. 


It is possible to insert a control character (such as CTRL-C) 
into text by using the quote character CTRL-V before the 
capital letter associated with it while in insert mode. 
CTRL-V tells MS-DOS to recognize the next capital letter 
typed as a control character. It is also possible to use a 
control character in any of the string arguments of Search 
or Replace by using the special quote character. For 
example: 


S CTRL-V CTRL-Z 


finds the first occurrence of CTRL-Z in a file. 
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R CTRL-V CTRL-Z CTRL-Z foo 

replaces all occurrences of CTRL-Z in a file by foo. 

It is possible to insert CTRL-V into the text by typing: 
CTRL-V CTRL-V 

The CTRL-Z character ordinarily tells EDLIN: 
This is the end of the file. 


If you have CTRL-Z characters elsewhere in your file, you 
must tell EDLIN that these other control characters do not 
mean end-of-file. Use the /B option to tell EDLIN to 
ignore any CTRL-Z characters in the file and to show you 
the entire file. 
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EDLIN Commands 
ee 
The EDLIN commands are summarized in the following table. 


They are described in further detail following the description of 
command options in this appendix. 


Command | Purpose 


Quits editing 

Replaces lines 
Searches text 

Transfers text 
Writes lines 


line Edits line no. 
A Appends lines 
(el Copies lines 
D Deletes lines 
E Ends editing 
I Inserts lines 
L Lists text 
M Moves lines 
P Pages text 
Q 
R 
Ss 
T 
Ww 
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How To Start EDLIN 


To start EDLIN, type: 
edlin <filename> 


If you are creating a new file, the filename should be the name of 
the file you wish to create. If EDLIN does not find this file on a 
drive, EDLIN creates a new file with the name you specify. The 
following message and prompt are displayed: 


New file 


Notice that the prompt for EDLIN is an asterisk (*). 


You can now type lines of text into your new file. To begin 
entering text, you must enter an I (Insert) command to insert 
lines. The Insert command is discussed later in this appendix. 


If you want to edit an existing file, filename should be the name 
of the file you want to edit. When EDLIN finds the file you 
specify on the designated or default drive, the file is loaded into 
memory. 


If the entire file can be loaded, EDLIN displays the following 
message on your screen: 


End of input file 


You can then edit the file using EDLIN editing commands. If the 
file is too large to be loaded into memory, EDLIN loads lines 
until memory is three-fourths full, then displays the * prompt. 
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You can then edit the portion of the file that is in memory. 


To edit the remainder of the file, you must save some of the 
edited lines on disk to free memory; then EDLIN can load the 
unedited lines from disk into memory. Refer to the Write and 
Append commands in this appendix for more information. 


When you complete the editing session, you can save the original 
and the updated (new) files by using the End command. The End 
command is discussed in this appendix in the section (E)nd. The 
original file is renamed with an extension of .BAK, and the new 
file has the filename and extension you specify in the EDLIN 
command. 


The original .BAK file is not erased until the end of the editing 
session, or until disk space is needed by the editor (EDLIN). 


Do not try to edit a file with a filename extension of .BAK 
because EDLIN assumes that any .BAK file is a back-up file. 


If you find it necessary to edit such a file, rename the file with 
another extension (using the MS-DOS RENAME command 
discussed in Chapter 5, MS-DOS Commands), then start EDLIN 
and specify the new filename. 
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Special Editing Keys 


The table below describes some of the commands, codes, and 
functions that are assigned to the special editing keys. 


The "command line" is the line on your screen where you enter 
the text and EDLIN commands for the line you are editing. A 
"template" is the line you create, in part, from the line you are 


editing. 

Function Key Description 

Copy one character Fl Copies one character from the 
template to the new line. 

Copy up to character | F2 Copies all characters from the template 
to the new line, up to the character 
specified, 

Copy template F3 Copies all remaining characters in the 
template to the screen. 

Skip one character | DEL Does not copy (skips over) a character. 

Skip up to character | F4 Does not copy (skips over) the 
characters in the template, up to the 
character specified. 

Quit input ESC Voids the current input; leaves the 
template unchanged. 

Insert mode INS Enters/exits insert mode. 

Replace mode INS F3 | Turns insert mode off; this is the 
default. 

New template F5 Makes the new line the new template. 
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F1 Key 


PURPOSE 


Copies one character from the template to the command line. 


COMMENTS 


Pressing F1 copies one character from the template to the 
command line. When F1 is pressed, one character is inserted 
in the command line and the insert key is disabled. 


EXAMPLE 


Assume that the screen shows: 


1:*This is a sample file. 
tie 


At the beginning of the editing session, the cursor (indicated 
by the underline) is positioned at the beginning of the line. 
Pressing F1 copies the first character (T) to the second of the 
two lines displayed: 


1:eThis is a sample file 
F. treat 


Each time F1 is pressed, one more character appears: 


F1 t:#Th_ 
FP. treThi_ 
F1 1:*This_ 
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F2 Key 
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PURPOSE 


Copies multiple characters up to a given character. 


COMMENTS 


Pressing F2 copies all characters up to a given character from 
the template to the command line. The given character is the 


next character typed after F2; it is not copied or displayed on 
the screen. 


Pressing F2 causes the cursor to move to the single character 
that is specified in the command. If the template does not 
contain the specified character, nothing is copied. Pressing F2 
also disables the insert key. 


EXAMPLE 


Assume that the screen shows: 


This is a sample file. 


At the beginning of the editing session, the cursor (indicated 
by the underline) is positioned at the beginning of the line. 
Pressing F2 copies all characters up to the character specified 
immediately after F2. 


1:sThis is a sample file 
F2p 1:*This is a sam_ 
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F3 Key 
a a eee 


PURPOSE 


Copies the template to the command line. 


COMMENTS 


Pressing F3 copies all remaining characters from the template 
to the command line. Regardless of the cursor position at the 
time F3 is pressed, the rest of the line appears, and the cursor 
is positioned after the last character on the line. Pressing F3 
also disables the insert key. 


EXAMPLE 
Assume that the screen shows: 


1:eThis is a sample file. 


die 


At the beginning of the editing session, the cursor (indicated 
by the underline) is positioned at the beginning of the line. 
Pressing F3 copies all characters from the template cursor. 


1:*This is a sample file (template) 
F3 1:#This is a sample file. (command line) 
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DEL Key 


—_—oOOO 


PURPOSE 


Skips over one character in the template. 


COMMENTS 


Pressing DEL skips over one character in the template. Each 
time you press DEL, one character is not copied from the 
template. The action of DEL is similar to F1, except that DEL 
skips a character in the template rather than copying it to the 
command line. 


EXAMPLE 


Assume that the screen shows: 


1:eThis is a sample file. 
tie 


At the beginning of the editing session, the cursor (indicated 
by the underline) is positioned at the beginning of the line. 
Pressing DEL skips over the first character (T): 


1:#This is a sample file 
DEL 1:8_ 
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The cursor position does not change and only the template is 
affected. To see how much of the line has been skipped over, 
press F3 to move the cursor beyond the last character of the 
line. 


li#This is a sample file. 
DEL 1:+_ 
P3 1:*ehis is a sample file._ 
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F4 Key 


PURPOSE 


Skips multiple characters in the template up to the specified 
character. 


COMMENTS 


Pressing F4 skips over all characters up to a given character in 
the template. This character is not copied and is not shown 
on the screen. If the template does not contain the specified 
character, nothing is skipped over. The action of F4 is similar 
to F2, except that F4 skips over characters in the template 
rather than copying them to the command line. 


EXAMPLE 


Assume that the screen shows: 


This is a sample file. 


die 


At the beginning of the editing session, the cursor (indicated 
by the underline) is positioned at the beginning of the line. 
Pressing F4 skips over all the characters in the template up to 
the character pressed after F4: 


1:*This is a sample file 
F4p t:e_ 
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The cursor position does not change. To see how much of the 
line has been skipped over, press F3 to copy the template. 
This moves the cursor beyond the last character of the line: 


J:*This is a sample file: 
F4pF3 1:*ple file._ 
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ESC Key 


PURPOSE 


Quits input and empties the command line. 


COMMENTS 


Pressing ESC empties the command line, but it leaves the 
template unchanged. ESC also prints a backslash (\), carriage 
return, line feed, and turns insert mode off. The cursor 
(indicated by the underline) is positioned at the beginning of 
the line. Pressing F3 copies the template to the command line 
and the command line is identical to the original template. 


EXAMPLE 


Assume that the screen shows: 


1:*This is a sample file. 


die 


At the beginning of the editing session, the cursor is 
positioned at the beginning of the line. Assume that you 
want to replace the line with "Sample File:" 


1:eThis is a sample file. 
1:*Sample File:_ 


To cancel the line you just entered ("Sample File"), and to keep 
"This is a sample file.," press ESC. Notice that a backslash 
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ee ——————— SSESSESESESESEeEe 


appears on the "Sample File” line to tell you it has been 
canceled. 


l:eThis is a sample file. 


ESC 1:*Sample File \ 
1: 


Press RETURN to keep the original line, or to perform any 
other editing functions. If you press F3 , the original template 
is copied to the command line: 


F3 1: This is a sample file._ 


B-19 


Appendix B 
EDLIN - The Line Editor 
INS Key 


INS Key 


PURPOSE 


Enters/exits insert mode. 


COMMENTS 


Pressing INS causes EDLIN to enter or exit insert mode. The 
current cursor (indicated by the underline) position in the 
template is not changed. The cursor moves as each character 
is inserted. However, when you have finished inserting 
characters, the cursor is positioned at the same character as it 
was before the insertion began. Thus, characters are inserted 
in front of the character that the cursor points to. 


EXAMPLE 


Assume that the screen shows: 


This is a sample file. 


At the beginning of the editing session, the cursor is 
positioned at the beginning of the line. Assume that you 
press F2 and f: 


1:*This is a sample file 
F2£ 1:*This is a sample _ 
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Now press INS and type the characters edit followed by a 
space: 


1isThis is a sample file. 
F2f 1:*This is a sample _ 
INSedit 1:*This is a sample edit _ 


If you now press F3, the rest of the template is copied to the 
line: 


1:eThis is a sample edit _ 
F3 1:*This is a sample edit file._ 


If you press RETURN , the remainder of the template would be 
truncated, and the command line would end at the end of the 
insert: 


INSedit RETURN 1:*This is a sample edit _ 


To exit insert mode, simply press INS again. 
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INS F3 Key 
8 


PURPOSE 


Enters replace mode. 


COMMENTS 


Pressing INS F3 causes EDLIN to exit insert mode and enter 

replace mode. All the characters you type replace characters 

in the template. When you start to edit a line, replace mode is 
in effect. If you press RETURN, the remainder of the template 

is deleted. 


EXAMPLE 


Assume that the screen shows: 


This is a sample file. 
tie 


At the beginning of the editing session, the cursor is 
positioned at the beginning of the line. Assume that you then 
press F2 m, INS lary, INS F3 tax, and then F3: 


1:eThis is a sample file. 

F2m 1:#This is a sa_ 

INSlary 1:*This is a salary_ 

INS F3 tax 1:#This is a salary tax_ 
F3 1:sThis is a salary tax file._ 


Notice that you inserted lary and replaced mple with tax. If 
characters on the command line extend beyond the length of 
the template, the remaining characters in the template are 
automatically appended when you press F3. 
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F5 Key 


ey 


PURPOSE 


Creates a new template. 


COMMENTS 


Pressing F5 copies the current command line to the template. 
The contents of the old template are deleted. Pressing F5 
outputs an @ ("at sign" character), a carriage return, and a line 
feed. The command line is also emptied and insert mode is 
turned off. 


Note: FS performs the same function as ESC, except that 
the template is changed and an @ is printed instead of a \. 


EXAMPLE 


Assume that the screen shows: 


1:*This is a sample file. 
die 


At the beginning of the editing session, the cursor (indicated 
by the underline) is positioned at the beginning of the line. 
Assume that you enter F2 m, INS lary, INS F3 tax, and then 
F3: 


1:*This is a sample file. 

F2m 1:*This is a sa_ 

INSlary 1:*This is a salary_ 

INS F3 tax 1:*#This is a salary tax_ 
F3 1:#This is a salary tax file._ 
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At this point, assume that you want this line to be the new 
template, so you press F5: 


F51:*#This is a salary tax file.@ 


The @ indicates that this new line is now the new template. 
Additional editing can be done using the new template. 
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eC Se 


Several EDLIN commands accept one or more options. The effect 
of a command option varies, depending on which command it is 
used with. The following sections describe the options. 


line 


line indicates a line number that you type. Line numbers must 
be separated by a comma or a space from other line numbers, 
other options, and from the command. line may be specified one 
of three ways: 


¢ Number—Any number less than 65,534. If a number 
larger than the largest existing line number is specified, 
then line means the line after the last line number. 


Period (.)—If a period is specified for line, then line 
means the current line number. The current line is the 
last line edited, and is not necessarily the last line 
displayed. The current line is marked on your screen by 
an asterisk (*) between the line number and the first 
character. 


Pound (#)—The pound sign indicates the line after the 
last line number. If you specify # for line, this has the 
same effect as specifying a number larger than the last line 
number. 


RETURN 


A carriage return entered without any of the line specifiers listed 
above directs EDLIN to use a default value appropriate to the 
command. 
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? 

The question mark option directs EDLIN to ask you if the correct 
string has been found. The question mark is used only with the 
Replace and Search commands. Before continuing, EDLIN waits 
for either a y or RETURN for a yes response, or for any other key 
fora no response. 


string 


string represents text to be found, to be replaced, or to replace 
other text. The string option is used only with the Search and 
Replace commands. Each string must be ended by a CTRL-Z ora 
RETURN (see the Replace command for details). No spaces should 
be left between strings or between a string and its command 
letter, unless you want those spaces to be part of the string. 
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(A)ppend 
8 


PURPOSE 


Adds the specified number of lines from disk to the file being 
edited in memory. The lines are added at the end of lines that 
are currently in memory. 


SYNTAX 
[n]A 


where: 

n = number of lines to be added 
and: 

[] = optional information. 


COMMENTS 


This command is meaningful only if the file being edited is 
too large to fit into memory. As many lines as possible are 
read into memory for editing when you start EDLIN. 


To edit the remainder of the file that does not fit into memory, 
lines that have already been edited must be written to disk. 
Then you can load unedited lines from disk into memory with 
the Append command. 


Refer to the Write command in this appendix for information 
on how to write edited lines to disk. 
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Notes: 


If you do not specify the number of lines to append, lines 
are appended to memory until available memory is three- 
fourths full. No action is taken if available memory is 
already three-fourths full. 


The message: 
End of input file 


is displayed when the Append command has read the last 
line of the file into memory. 
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(C)opy 


eee 


PURPOSE 


Copies a range of lines toa specified line number. The lines 
can be copied as many times as you want by using the count 
option. 


SYNTAX 
{line1], [line2],<line3> [,count]C 


where: 
line1 — first line number in a range 
line2 = last line number in a range 
line3 = line number before which insertion is to 
be made 
count = number of times to copy 


and: 
<> = required information 
[] = optional information. 
COMMENTS 


If you do not specify a number in count, EDLIN copies the 
lines one time. If line1 or line2 is omitted, the default is the 
current line. The file is renumbered automatically after the 


copy. 
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ee ee 
The line numbers must not overlap or the message: 
Entry error 
appears. For example: 
3,20,15¢ 


would result in an error message. 


EXAMPLES 


Assume that the following file exists and is ready to edit: 


This is a sample file 
used to show copying lines. 
See what happens when you use 
the Copy command 

(the C commana) 

to copy text in your file. 


3: 
4: 
5: 
6: 


You can copy this entire block of text by issuing the following 
command: 


1,6,7¢ 
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———jHaAiqoqoqo<qquoewu- 
The result is: 


1: This is a sample file 

2: used to show copying lines. 

3: See what happens when you use 
4: the Copy command 

5: (the C command) 

6: to copy text in your file. 

7: This is a sample file 

8: used to show copying lines. 
9: See what happens when you use 
10: the Copy command 

11: (the C command) 

12: to copy text in your file. 


If you want to place the text within other text, line3 should 
specify the line before which you want the copied text to 
appear. For example, assume that you want to copy lines and 
insert them within the following file: 


This is a sample file 
used to show copying lines. 
See what happens when you use 
the Copy command 

(the C command) 

to copy text in your file. 
You can also use COPY 

to copy lines of text 

to the middle of your file. 
End of sample file. 


Swmrnuaunes 
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The command: 


3,6,10¢ 


results in the following file: 


4: 
2: 
3: 
4: 
5: 
6: 
Te 


This is a sample file 

used to show copying lines. 
See what happens when you use 
the Copy command 

(the C command) 

to copy text in your file. 
You can also use COPY 

to copy lines of text 

to the middle of your file. 
See what happens when you use 
the Copy command 

(the C command) 

to copy text in your file. 
End of sample file. 
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(D)elete 


—— 


PURPOSE 


Deletes a specified range of lines in a file. 


SYNTAX 
[line1}[,line2]D 


where: 
linel = first line number in a range 
line2 = last line number in a range 
and: 
[] = optional information. 


COMMENTS 


If linel is omitted, that option defaults to the current line (the 
line with the asterisk next to the line number). If line2 is 
omitted, then just linel is deleted. When lines have been 
deleted, the line immediately after the deleted section 
becomes the current line and has the same line number as the 
first deleted line had before the deletion occurred. 
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EXAMPLES 


Assume that the following file exists and is ready to edit: 


This is a sample file 

used to show dynamic line numbers. 
See what happens when you use 
Delete and Insert 


RuUNo 


25: (the D and I commands) 
26: to edit the text 
27:4in your file. 


To delete multiple lines, type: 
5,244 


The result is: 


This is a sample file 

used to show dynamic line numbers. 
see what happens when you use 
Delete and Insert 

:#(the D and I commands) 

to edit text 

in your file. 


woaus.uns 


To delete a single line, type: 


6d 
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The result is: 


1: This is a sample file 

2: used to show dynamic line numbers. 
3: See what happens when you use 

4: Delete and Insert 

5: (the D and I commands) 

6:*in your file. 


Next, delete a range of lines from the following file: 


1: This is a sample file 

2: used to show dynamic line numbers. 
3:*#See what happens when you use 

4: Delete and Insert 

5: (the D and I commands) 

6: to edit text 
7: in your file. 


To delete a range of lines beginning with the current line, 
type: 


od 
The result is: 


1: This is a sample file 
2: used to show dynamic line numbers. 
3:#in your file. 


Notice that the lines are automatically renumbered. 
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<line> Edit 
ee ee eee Sey ee 


PURPOSE 


Edits a line of text. 


SYNTAX 
[line] 


where: 
line = a line number to edit 
and: 
[] = optional information. 


COMMENTS 


When a line number is typed, EDLIN displays the line number 
and text; then, on the line below, EDLIN reprints the line 
number. The line is now ready for editing. You may use any 
of the EDLIN editing commands to edit the line. The existing 
text of the line serves as the template until RETURN is pressed. 


Warning: If RETURN is pressed while the cursor is in the 
middle of the line, the remainder of the line is deleted. 


EXAMPLE 
Assume that the following file exists and is ready to edit: 


1: This is a sample file. 
2: used to show 

3: the editing of line 
4:*four. 
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To edit line 4, type: 


The contents of the line are displayed with a cursor below the 
line: 


4: four. 
are 


Now, press F3 and type: 


insnumber 4: number_ 
F3 RETURN 4: number four. 
5:*_ 
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(E)nd 


PURPOSE 


Ends the editing session. 


SYNTAX 


E 


COMMENTS 


This command saves the edited file on disk, renames the 
original input file filename.BAK, and then exits EDLIN. If the 
file was created during the editing session, no .BAK file is 
created. 


The End command takes no options. When you begin EDLIN, 
you must enter the file specification for the output file. If the 
drive is not selected when EDLIN is started, the file is saved 
on the disk in the default drive. It is still possible to COPY 
the file to a different drive using the MS-DOS COPY 
command. 


You must be sure that the disk contains enough free space for 
the entire file. If the disk does not contain enough free space, 
the write is aborted and the edited file lost, although part of 
the file might be written to the disk. 


EXAMPLE 
e RETURN 


After execution of the End command, the MS-DOS default 
drive prompt (for example, A>) is displayed. 
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(Insert 
a ee 


PURPOSE 


Inserts text immediately before the specified line. 


SYNTAX 
[line]I 


where: 
line = line number before which insertion is to 
be made 
and: 
[] = optional information. 


COMMENTS 


If you are creating a new file, the Insert command must be 
given before text can be typed (inserted). Text begins with 
line number 1. Successive line numbers appear automatically 
each time RETURN is pressed. 


EDLIN remains in insert mode until you press either CTRL-C 
or CTRL-Z RETURN. 


When the insert is completed and insert mode is finished, the 
line immediately following the inserted lines becomes the 
current line. All line numbers following the inserted section 
are incremented by the number of lines inserted. 


If line is not specified, the default is the current line number 
and the lines are inserted immediately before the current line. 
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If line is any number larger than the last line number, or if a 
pound sign (#) is specified as line, the inserted lines are 
appended to the end of the file. In this case, the last line 
inserted becomes the current line. 


EXAMPLES 


Assume that the following file exists and is ready to edit: 


This is a sample file 

used to show dynamic line numbers. 
See what happens when you use 
Delete and Insert 

(the D and I commands) 

to edit text 

rein your file. 


Yaurwns 


To insert text before a specific line that is not the current line, 


type: 


Ti 


The result is: 


Now, type the new text for line 7: 


nd renumber lines 
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Then, to end the insertion, press RETURN; on the next line, 
press CTRL-Z ; and then press RETURN: 


8: CTRL-Z RETURN 
Now, to list the file and see the result, type: 
L 


The result is: 


This is a sample file 

used to show dynamic line numbers. 
See what happens when you use 
Delete and Insert 

(the D and I commands) 

to edit text 

and renumber lines 

rein your file. 


OYyaneuns 


To insert lines immediately before the current line, type: 


The result is: 


Appendix B 
EDLIN - The Line Editor 
()nsert 


Now, insert the following text and terminate with a CTRL-Z 
RETURN on the next line: 


8: so they are consecutive 
9: CTRL-Z RETURN 


Now, to list the file and see the result, type: 


IL. 


The result is: 


This is a sample file 
used to show dynamic line numbers 
See what happens when you use 
Delete and Insert 

5: (the D and I commands) 

6: to edit text 

7: and renumber lines 

8 

9 


: so they are consecutive 
rein your file. 


To append new lines to the end of the file, type: 
10i 


The result is: 
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Now, type the following new lines: 


10: The insert command can place new lines 
11: in the file; there’s no problem 

12: because the line numbers are dynamic; 
13: they'll go all the way to 65533. 


To end the insertion, press CTRL-Z on line 14. The new lines 
appear at the end of all previous lines in the file. 


Now, to list the file and see the result, type: 
L 
The result is: 


1: This is a sample file 

2: used to show dynamic line numbers. 

3: See what happens when you use 

4: Delete and Insert 

5: (the D and I commands) 

6: to edit text 

7: and renumber lines 

8: so they are consecutive 

9: in your file. 

10: The insert command can place new lines 
11: in the file; there’s no problem 
12: because the line numbers are dynamic; 
13: they’11 go all the way to 65533. 
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—— eS 
PURPOSE 


Lists a range of lines, including the two lines specified. 
SYNTAX 
[line1][line2]L 
where: 
linel = first line number in a range 


line2 = last line number in a range 
and: 


0 


optional information. 


COMMENTS 


Default values are provided if either one or both of the 
options are omitted. If line1 is omitted, the display starts 11 
lines before the current line and ends with line2. The 
beginning comma is required to indicate the omitted first 
option. 


Note: If the specified line is more than 11 lines before the 
current line, the display is the same as if you omitted both 
options. 


If line2 is omitted, 23 lines are displayed, starting with the 
specified line. 
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If you omit both parameters, as in: 
L 


23 lines are displayed — the 11 lines before the current line, 
the current line, and the 11 lines after the current line. If 
there are less than 11 lines before the current line, more than 
11 lines after the current line are displayed to make a total of 
23 lines. 


EXAMPLES 
Assume that the following file exists and is ready to edit: 


1: This is a sample file 

2: used to show dynamic line numbers 
See what happens when you use 
Delete and Insert 

(the D and I commands) 


15:*The current line contains an asterisk. 


26: to edit text 
27: in your file. 


To list a range of lines without reference to the current line, 
type: 


2,5L 
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2: used to show dynamic line numbers. 
3: See what happens when you use 

4: Delete and Insert 
5 (the D and I commands) 


To list a range of lines beginning with the current line, type: 
26L 
The result is: 


1S5:*The current line contains an asterisk. 


26: to edit text 


To list a range of 23 lines centered around the current line, 
type: 
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Como 


The result is: 


4: Delete and Insert 
5: (the D and I commands) 
3: The current line is listed in the middle 


of the range. 

4: The current line remains unchanged by 
the L command. 

S:*The current line contains an asterisk. 


6: to edit text. 
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(M)ove 


PURPOSE 


Moves a range of text to the line specified. 
SYNTAX 
[line1],[line2],<line3>M 
where: 
line1 = first line number in a range 


line2 = last line number in a range 
line3 = line number before which insertion is to 


be made 
and: 
<> = required information 
[J = optional information. 
COMMENTS 


Use the Move command to move a block of text (from line1 to 
line2) to another location in the file. Text is inserted before 
the target line, and the lines are renumbered according to the 
direction of the move. For example, 


,+25,100m 


moves the text from the current line plus 25 lines to line 100. 
If the line numbers overlap, EDLIN displays the message: 


Entry error 
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(P)age 
——-—-__—_—_———S—S—S——_______ 
PURPOSE 

Pages through a file 23 lines at a time. 
SYNTAX 
[line1][,line2]P 
where: 
line1 = line number where paging is to begin 


line2 = line number where paging is to end 
and: 
0 


optional information. 


COMMENTS 


If line1 is omitted, that number defaults to the current line 
plus one. If line2 is omitted, 23 lines are listed. The new 

current line becomes the last line displayed and is marked 
with an asterisk. 
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(Q)uit 


PURPOSE 


Quits the editing session, does not save any editing changes, 
and exits to the MS-DOS operating system. 


SYNTAX 
Q 


COMMENTS 


EDLIN prompts you to make sure you do not want to save the 
changes. 


Type: 


if you want to quit the editing session. 
No editing changes are saved and no .BAK file is created. 
Refer to the End command in this appendix for information 


about the .BAK file. 


Type: 


or any other character except y if you want to continue the 
editing session. 
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CV 


Note: When started, EDLIN erases any previous copy of 
the file with an extension of .BAK to make room to save 
the new copy. If you reply: 


to the 
Abort edit (¥/N)? 


message, your previous back-up copy no longer exists. 


EXAMPLE 
q 


Abort edit (Y/N)? 
y RETURN 


A> 
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(R)eplace 


PURPOSE 


Replaces all occurrences of a string of text in the specified 
range with a different string of text or blanks. 


SYNTAX 
[line1][line2][?]R <string1> CTRL-Z <string2> 


where: 
linel = first line number in a range 
line2 = last line number in a range 
? = EDLIN asks if last replacement was correct 
string] = text to be replaced 
string2 = replacement text 


and: 
<> = required information 
{] = optional information. 
COMMENTS 


As each occurrence of string] is found, it is replaced by 
string2. Each line in which a replacement occurs is displayed. 
If a line contains two or more replacements of string1 with 
string2, then the line is displayed once for each occurrence. 


When all occurrences of string] in the specified range are 
replaced by string2, the Replace command terminates and the 
asterisk prompt reappears. 


If a second string is to be given as a replacement, then string] 
must be separated from string2 with a CTRL-Z. String2 must 
end with a CTRL-Z RETURN combination or with a simple 
RETURN. 
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If string1 is omitted, then Replace takes the old string] as its 
value. If there is no old string] (that is, this is the first replace 
done), then the replacement process ends immediately. 


If linel is omitted (as in ,line), then line1 defaults to the line 
after the current line. If line2 is omitted (as in line or line), 
line2 defaults to #. Therefore, Rstringl <string2> is the 
same as current line+1,# (the line after the last line of text). 
If string1 is ended with a CTRL-Z and there is no string2, 


string2 is taken as an empty string and becomes the new 
replace string. For example, 


Rstring2 CTRL-Z 
deletes all of string1, but 
Rstring1 
and 
R 


both use the old string2 and the later example also uses the 
old string1. Note that "old" here refers to a previous string 
specified either in a Search or a Replace command. 
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If the question mark (?) option is used, the Replace command 
stops at each line with a string that matches string1, displays 
the line with string2 in place, and then displays the prompt: 


If you type: 
y 


or press the RETURN key, then string2 replaces string1, and 
the next occurrence of string] is found. 


Again, the prompt: 


is displayed. This process continues until the end of the range 
or until the end of the file. After the last occurrence of 
string] is found, EDLIN displays the asterisk prompt. 


If you press any key besides: 


y 


or RETURN after the prompt: 
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string] is left as it was in the line, and Replace goes to the 
next occurrence of string. If string1 occurs more than once 


in a line, each occurrence of string] is replaced individually, 
and the prompt: 


is displayed after each replacement. In this way, only the 
desired string1 is replaced, and you can prevent unwanted 
substitutions. 


EXAMPLES 


Assume that the following file exists and is ready for editing: 


So wmraueuna 


This is a sample file 

used to show dynamic line numbers. 
See what happens when you use 

Delete and Insert 

(the D and I commands) 

to edit text 

in your file. 

The insert command can place new lines 
in the file; there’s no problem 
because the line numbers are dynamic; 
they’1l go all the way to 65533. 
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To replace all occurrences of "and" with "or" in a specified 


range, type: 
2,12 Rand CTRL-Z or 


and press RETURN. 


The result is: 


4: Delete or Insert 

(the D or I commands) 

(the D or I commors) 

8: The insert commor can place new lines 


Note that in the previous replacement, some unwanted 
substitutions have occurred. To avoid these and to confirm 
each replacement, the same original file can be used with a 
slightly different command. 


In the next example, to replace only certain occurrences of 
"and" with "or", type: 


2,12? Rand CTRL-Z or 


and press RETURN. 
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CO 
The result is: 


4: Delete or Insert 
O.K.? ¥ 
5: (the D or I commands) 
O.K.? ¥ 
5: (the D or I commors) 
O.K.? N 
8: The insert commor can place new lines 
O.K.? N 


Now, type the List command (L) to see the result of all these 
changes: 


Delete or Insert 
(the D or I commands) 


The insert command can place new lines 
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(S)earch 


PURPOSE 


Searches the specified range of lines for a specified string of 
text. 


SYNTAX 
[line1][ line2][?]S <string> 


where: 
linel = first line number in a range 
line2 = last line number in a range 
? = EDLIN asks if correct string was found 
string = text to be found 


and: 
<> = required information 
[] = optional information. 
COMMENTS 


The string must be followed by a RETURN. The first line that 
matches string is displayed and becomes the current line. If 
the question mark (?) option is not specified, the Search 
command ends when a match is found. If no line contains a 
match for string, the message: 


Not found 


is displayed. 
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If the question mark option is included in the command, 
EDLIN displays the first line with a matching string; it then 
prompts you with the message: 


O.K.? 
If you type: 
y 


or press RETURN, the line becomes the current line and the 
search ends. 


If you press any other key, the search continues until another 
match is found, or until all lines have been searched, and the 
message: 


Not found 


is displayed. 


If line is omitted (as in ,line), the line1 defaults to the after 
the current line. If line2 is omitted (as in line or line,), line2 
defaults to # (the line after the last line of text). Therefore, 
S<string> is the same as current line+1,#. 


If string is omitted, Search takes the old string if there is one. 
(Note that "old" here refers to a string specified in a previous 
Search or Replace command.) If there is not an old string 
(that is, no previous search or replace has been done), the 
command ends immediately. 
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EXAMPLES 


Assume that the following file exists and is ready for editing: 


a: 
2: 
3: 
4: 
S: 
6: 
7: 
8: 
9: 
0: 

a4: 


This is a sample file 

used to show dynamic line numbers. 

See what happens when you use 

Delete and Insert 

(the D and I commands) 

to edit text 

in your file. 

The insert command can place new lines 
in the file; there’s no problem 
because the line numbers are dynami 
«they’11 go all the way to 65533. 


To search for the first occurrence of "and" in a specified range, 


type: 


1,12 Sand 


The result is: 


4: 


To get 
typing 


Delete and Insert 


the "and" in line 5, modify the search command by 


DEL F3,12 Sand 
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The search then continues from the line after the current line 
(line 4), since no first line was given. The result is: 


5: (the D and I commands) 


To search through several occurrences of a string until the 
correct string is found, type: 


1,? Sand 


The result is: 


4: Delete and Insert 
0.K.?_ 


If you press any key (except y or RETURN), the search 
continues, so type: 


The next occurrence of the string appears: 


5: (the D and I commands) 
O.K.7_ 
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To terminate the search, type: 


x 
The result is: 


O.K.?¥ 


To search for string XYZ from the line after the current line to 
the end without the verification (O.K.?), type: 


Sxyz 


EDLIN reports a match and continues to search for the same 
string when you issue the S command: 


Ss 
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(T)ransfer 
ee eee 


PURPOSE 


Inserts (merges) the contents of another file into the file 
currently being edited at a specified line. 


SYNTAX 
[line]T <filename> 


where: 
line = line number in the current file before 
which insertion of other file is to be made 
filename = file to be copied 


and: 
<> = required information 
{] = optional information. 
COMMENTS 


This command is useful if you want to put the contents of a 
file into another file or into the text you are typing. The 
transferred text is inserted at the line number specified by line 
and the lines are renumbered 


If line is omitted, the current line is used. 
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(W): 


rite 


(W)rite 


PURPOSE 


Writes a specified number of lines to disk from the lines that 
are being edited in memory. Lines are written to disk 
beginning with line number 1. 


SYNTAX 


[n]W 


where: 

n = number of lines to be written to disk 
and: 

[] = optional information. 


COMMENTS 


This command is meaningful only if the file you are editing is 
too large to fit into memory. When you start EDLIN, EDLIN 
reads lines into memory until memory is three-fourths full. 


To edit the remainder of your file, you must write edited lines 
in memory to disk. Then you can load additional unedited 
lines from disk into memory by using the Append command. 


Note: If you do not specify the number of lines, lines are 
written until memory is three-fourths full. No action is 
taken if available memory is already less than three- 
fourths full. All lines are renumbered, so that the first 
remaining line becomes line number 1. 
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Messages 


Cannot edit .BAK file—rename file 
You attempted to edit a file with a filename extension of 


-BAK. BAK files cannot be edited because this extension is 
reserved for back-up copies. 


If you need the .BAK file for editing purposes, you must 
either rename the file with a different extension or COPY the 
-BAK file and give it a different filename extension. 


Disk full—file write not completed 
You gave the End command, but the disk did not contain 
enough free space for the whole file. EDLIN aborted the End 
command and returned you to the operating system. Some of 
the file may have been written to the disk. 


Only a portion (if any) of the file has been saved. You should 
probably delete that portion of the file and restart the editing 
session. The file is not available after this error. Always be 
sure that the disk has sufficient free space for the file to be 
written to disk before you begin your editing session. 


Entry Error 
The last command typed contained a syntax error. Retype the 
command with the correct syntax and press RETURN. 


File creation error 
The EDLIN temporary file cannot be created. 


Make sure that the directory has enough space to create the 
temporary file. Also, make sure that the file does not have 
the same name as a subdirectory in the directory where the 
file to be edited is located. 
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Filename must be specified 
You did not specify a filename when you started EDLIN. 


Specify a filename. 


File not found 
The filename specified during a Transfer command was not 
found. 


Specify a valid filename when issuing a Transfer command. 


Incorrect MS-DOS version 
You attempted to run EDLIN under a version of MS-DOS that 
was not 2.0 or higher. 


Make sure that the version of MS-DOS that you are using is 
2.0 or higher. 


Insufficient memory 
There is not enough memory to run EDLIN. 


Free some memory by saving the contents of memory to disk 
or by clearing memory before restarting EDLIN. 


Invalid drive name or file 
You have not specified a valid drive or filename when 
starting EDLIN. 


Specify the correct drive or filename. 


Line too long, 
During a Replace command, the string given as the 
replacement caused the line to expand beyond the limit of 
253 characters. EDLIN aborted the Replace command. 


Divide the long line into two lines, then try the Replace 
command. 
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Must specify destination number 


A destination line number was not specified for a Copy or 
Move command. 


Reissue the command with a destination line number. 


No room in directory for file 
When you attempted to create a new file, either the file 


directory was full or you specified an illegal disk drive or an 
illegal filename. 


Check the command line that started EDLIN for illegal 
filename and illegal disk drive entries. If the command is no 
longer on the screen and if you have not yet typed a new 
command, the EDLIN start command can be recovered by 
pressing F3. If this command line contains no illegal entries, 
run the CHKDSK program for the specified disk drive. If the 
status report shows that the disk directory is full, remove the 
disk. Insert and format a new disk. 


Not enough room to merge the entire file 
There was not enough room in memory to hold the file 
during a Transfer command. 


You must free some memory by writing some files to disk or 
by deleting some files before you can transfer this file. 
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Overview 


LINK is an executable program on your MS-DOS Supplemental 
Programs Diskette. LINK combines object modules that are the 
output of the MACRO-86 assembler or compatible compiler. It 
produces a relocatable run file (load module) and a list file of 
external references and error messages. 


To run LINK, you provide object, run, list, and library file 
parameters. You may enter options that modify the operation of 
LINK. 


The section Invoking LINK describes the three ways to run 
LINK: Interactive Entry, Command Line Entry, and Automatic 
Response File Entry. Interactive Entry is used most frequently, so 
its section contains information common to all three methods. 


If you are linking a high-level language program, the compiler 
determines the arrangement of your object modules in memory. 
If you are using assembler, however, you have more control over 
your program’s organization. The section Segments, Groups, and 
Classes in this chapter shows you how to specify the order of 
your object modules at run time. 
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LINK File Usage 


The LINK process involves the use of several files. LINK: 


* Works with one or more input files 
* Produces two output files 
* Creates a temporary disk file if necessary 


© Searches up to eight library files. 


Syntax 


The format for LINK file specifications is the same as that of any 
disk file: 


[drive:][path] <filename> 


where: 
drive = drive designation. Permissible drive 
designations for LINK are A: through 0: 
path = path of directory names 
filename = legal filename of 1 to 8 characters, plus an 
optional extension of 1 to 3 characters 
and: 
<> = required information 
[] = optional information. 
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If no filename extensions are given in the input (object) file 
specifications, LINK recognizes the following extensions by 
default: 


OBJ (Object) 
-LIB (Library) 


LINK appends the following default extensions to the output (run 
and list) files: 


-EXE (Run) (may not be overridden) 
-MAP (List) (may be overridden) 


VM.TMP File 


LINK uses available memory for the link session. If an output 
file exceeds available memory, LINK creates a temporary file, 
names it VM.TMP, and puts it on the disk in the default drive. If 
LINK creates VM.TMP, it will display the message: 


VM.TMP has been created. 
Do not change diskette in drive, <d:> 


Once this message is displayed, do not remove the diskette from 
the default drive until the link session ends. If the diskette is 
removed, the operation of LINK is unpredictable and LINK 
usually displays the error message: 


Unexpected end of file on VM. TMP 
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LINK writes the contents of VM.TMP to the file named following 
the prompt: 


Run File: 


VM.TMP is a working file only and is deleted at the end of the 
linking session. 


Do not use VM.TMP as a filename for any file. If LINK requires 
the VM.TMP file, LINK deletes the VM.TMP already on disk and 
creates anew VM.TMP. Thus, the contents of the previous 
VM.TMP file are lost. 


Changing Diskettes 


You may want to change diskettes during the link operation. If 
LINK cannot find an object file on the specified diskette, it 
prompts you to change diskettes rather than aborting the session. 
If you enter the /PAUSE option (described in the LINK Options 
section of this chapter), LINK pauses and prompts you to change 
diskettes before it creates the run file. You may change diskettes 
when prompted except in the following cases: 


* The diskette you want to change has a VM.TMP file on it. 


* You have requested a list file on the diskette you want to 
change. 
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Segments, Groups, and Classes 


Definitions 


The following terms are explained to help you understand how 
LINK works. Generally, if you are linking object modules from a 
high-level language compiler, you do not need to know these 
terms. If you are linking assembly language modules, read this 
section carefully. 


Segment 
A segment is a contiguous area of memory up to 64 Kb in 
length. A segment may be located anywhere in 8086 
memory on a "paragraph" (16-byte) boundary. The contents 
of a segment are addressed by a segment-register-offset pair. 


Group 
A group is a collection of segments. If you are using 
assembly language, you name the group. For high-level 
languages, the compiler names the group. 


The group is used for addressing segments in memory. Each 
group is addressed by a single segment register. The 
segments within the group are addressed by the segment 
register plus an offset. LINK checks to see that the total sizes 
of the object modules within one group do not exceed 64 Kb. 
A program consists of one or more groups. 


Class 
A class is a collection of segments. You assign the class name 
for assembly language programs; the compiler assigns the 
class name for high-level language programs. 


Segments are grouped together by the class name found in 
the object modules. Classes may be loaded across 64-Kb 
boundaries. LINK divides classes into groups that are no 
longer than 64 Kb. 
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Segment Name Segment 
Name Class 


Segment 1 PROG.1 CODE 
Segment 2 PROG.2 CODE 
Segment 12 PROG.3 DATA 


Note that segments 1, 2, and 12 have different segment names, 
but may or may not have the same segment class name. 
Segments 1, 2, and 12 form a group with a group address of the 
lowest address of segment 1 (that is, the lowest address in 
memory). 


Each segment has a segment name and a class name. LINK loads 
all segments into memory by class name from the first segment 
encountered to the last. All segments assigned to the same class 
are loaded into memory continuously. 


During processing, LINK references segments by their address in 
memory (where they are located). LINK does this by finding 
groups of segments. 
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Invoking LINK 
a 


Ways to Invoke Link 


LINK is invoked in one of three ways. The first method, 
Interactive Entry, requires you to respond to individual prompts. 
For the second method, Command Line Entry, type all commands 
on the same line used to start LINK. To use the third method, 
Automatic Response File Entry, create a response file that contains 
all the necessary commands and tell LINK where that file is when 
you run LINK. 


Interactive Entry link 
Command Line Entry __ link filenames[/options] 
Automatic Response link @ filename 


File Entry 


Interactive Entry 


To invoke LINK interactively, type: 
link 


LINK loads into memory, then displays four prompts, one at a 
time. At the end of each line, you may type one or more options 
preceded by a forward slash. 


The command prompts are summarized on the next page. 
Defaults appear in square brackets ([]) after the prompt. Object 
Modules is the only prompt that requires a response 


ce 
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LINK Prompts 


Object Modules[.OBJ}: _ [d:][path]name[.ext] 
(+[d:][path][name].ext]]... 


Run File[{name.EXT]: [d:][path][name[.ext]] 
List File[/NUL.MAP]: [d:]J[path][name[.ext]] 


Librariesf.LIB]: [d:J[path][namef.ext] 
[+d:][[path]Jname{.ext]]... 


Notes: 


If you enter a filename without specifying the drive, the 
default drive is assumed. If you enter a filename without 
specifying the path, the default path is assumed. The libraries 
prompt is an exception—if the linker looks for the libraries 
on the default drive and doesn’t find them, it looks on the 
drive specified by the compiler. 


To select default responses to the remaining prompts, use a 


single semicolon (;) followed immediately by RETURN at any 
time after the first prompt: 


Run File:. 


Once you enter the semicolon, you can no longer respond to 
any of the prompts for that link session. Use RETURN to skip 
prompts. 


Use CTRL-C to abort the link session at any time. 
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Object Modules To Be Included 
Object Modules[.OBJ]: 


List .OBJ files to be linked. They must be separated by blank 
spaces or plus signs (+). If the plus sign is the last character 
typed, this prompt will reappear so that you can enter more 

object modules. 


LINK assumes that object modules have the extension .OBJ unless 
you explicitly specify some other extension. Object filenames 
may not begin with the @ symbol (@ is used for specifying an 
automatic response file). 


The order in which you key in the object files is significant. See 
the Segments, Groups, and Classes section of this chapter for 
more information. 


Load Module 
Run File [Obj-file.EXE]: 


Give filename for executable object code. The default is: 
<first-object-filename>.EXE. You cannot change the output 
extension. You can specify just the drive designation or just a 
path. 


Listing 

List File [NUL.MAP]: 
Give filename for listing (also known asa linker map). The 
listing is not created if you select the default. You can request a 
listing by entering a drive designator, path, or name [.ext]. If you 
do not specify an extension, the default MAP is used. 
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You can have the listing printed by specifying a print device 
instead of a filename or have the listing displayed on the screen 
by specifying CON. If you display the linker map, you can also 
print it by pressing CTRL-PrtSc. 


Libraries To Be Searched 
Libraries [.LIB]: 


List filenames to be searched separated by blank spaces or plus 
signs (+). If a plus sign is the last character typed, the prompt 
will reappear. 


LINK searches library files in the order listed to resolve external 
references. When it finds the module that defines the external 
symbol, LINK processes that module as another object module. 


There is no default library search for MACRO assembler object 
modules. For compiled modules, if you select the default for this 
prompt, LINK looks for the compiler package’s library on the 
default drive. If not found there, LINK looks on the drive 
specified by the compiler. 


If LINK cannot find a library file, it displays: 


Cannot find library <library-name> 
Type new drive letter: 


Press the letter for the drive designation (for example, B). If two 
libraries have the same filename, only the first in the list is 
searched. 
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LINK Options 


—— se 


The seven LINK options control various LINK functions. Type 
options at the end of a prompt response regardless of which 
method you use to start LINK. Options may be grouped at the 
end of any response, or may be scattered at the end of several. If 
you type more than one option at the end of one response, each 
option must be preceded by a forward slash (/). 


All options may be abbreviated. The only restriction is that an 
abbreviation must be sequential from the first letter through the 
last typed; no gaps or transpositions are allowed. For example: 


Legal Illegal 

{D /DSL 

/DS /DAL 

[DSA /DLC 
IDSALLOCA | /DSALLOCT 


/DSALLOCATE 


/DSALLOCATE tells LINK to load all data at the high end of the 
data segment. Otherwise, LINK loads all data at the low end of 
the data segment. At run time, the DS pointer is set to the lowest 
possible address to allow the entire DS segment to be used. 


Use of /DSALLOCATE in combination with the default load low 
(that is, the /HIGH option is not used) permits the user 
application to dynamically allocate any available memory below 
the area specifically allocated within DGroup yet to remain 
addressable by the same DS pointer. This dynamic allocation is 
needed for Pascal and FORTRAN programs. 
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Your application program may dynamically allocate up to 64 Kb 
(or the actual amount of memory available) less the amount 
allocated with DGroup. 


/HIGH 


J HIGH causes LINK to place the run file as high as possible in 
memory. Otherwise, LINK places the run file as low as possible. 


Note: Do not use /HIGH with Pascal or FORTRAN programs. 


/LINENUMBERS 


/LINENUMBERS tells LINK to include in the list file the line 
numbers and addresses of the source statements in the input 
modules. Otherwise, line numbers are not included in the list 
file. 


Not all compilers produce object modules that contain line 
number information. In these cases, of course, LINK cannot 
include line numbers. 


/MAP 


/MAP directs LINK to all public (global) symbols defined in the 
input modules. If /MAP is not given, LINK will list only errors 
(including undefined globals). 


The symbols are listed alphabetically. For each symbol, LINK 
lists its value and its segment:offset location in the run file. The 
symbols are listed in the end of the list file. 
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/ PAUSE 


/ PAUSE causes LINK to pause in the link session when the 
option is encountered. Normally, LINK performs the linking 
session from beginning to end without stopping. This option 
enables you to swap the diskettes before LINK outputs the run 
(-EXE) file. 


When LINK encounters /PAUSE, it displays the message: 


About to generate .EXE file 
Change disks <hit any key> 


LINK resumes processing when you press any key. 


Note: Do not remove the disk that will receive the list file, or 
the disk used for the VM.TMP file, if one has been created. 


/STACK: <number> 


/STACK: <number> represents any positive numeric value (in 
hexadecimal radix) up to 65,536 bytes. If a value from 1 to 511 is 
typed, LINK will use 512. If /STACK is not used for a link 
session, LINK calculates the necessary stack size automatically. 


All compilers and assemblers should provide information in the 
object modules that allow the linker to compute the required 
stack size. 


At least one object (input) module must contain a stack allocation 
statement. If not, LINK will display the following error message: 


WARNING:NO STACK STATEMENT 
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/NO 


INO is short for NO DEFAULT LIBRARY-SEARCH. This option 
applies only to higher-level language modules. This option tells 
LINK not to search the default libraries in the object modules. 


For example, if you are linking object modules in Pascal, 
specifying /NO tells LINK not to automatically search the library 
named PASCAL.LIB to resolve external references. 
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Command Line Entry 


oo 


You may invoke LINK by typing all commands on one line. The 
entries following LINK are responses to the command prompts. 
The entry fields for the different prompts must be separated by 
commas. Use the following syntax: 


LINK <obj-list>,<runfile> ,<listfile> ,<lib-list> [/option...] 


where: 
obj-list = list of object modules, separated by plus 
signs. 
runfile = name of the file to receive the executable 
output. 
listfile = name of the file to receive the listing. 
lib-list = list of library modules to be searched. 
/option = refers to options that may be placed 
following any of the response entries (just 
before any of the commas or after the 
lib-list, as shown. 
and: 
<> = required information. 
[] = optional information. 


To select the default for a field, simply type a second comma with 
no spaces between the two commas. For example: 


link 
funttext+tablet+care,funlist, 
coblib.lib 
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Automatic Response File Entry 


It is often convenient to save responses to the linker for reuse at a 
later time. This is especially useful when a long list of object 
modules needs to be specified. 


Before using this option, you must create the response file. Each 
line of text corresponds to one LINK prompt. The responses must 
be typed in the same order as they are when entered ~ 
interactively. To continue a line, type a plus sign (+) at the end 
of the line. 


You can enter the name of more than one automatic response file 
on the command line and combine response file names with 
additional parameters. The combined series of resulting 
parameters must be a valid sequence of LINK prompts. 


Use options and special characters (+ and ;) in the response file 
the same way they are used when entered interactively. 


To invoke the linker using a response file, type: 


link @ <filename> 


where: 
filename = the name of a response file. The extension 
is not required. 
and: 
<> = required information. 
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When the session begins, LINK displays each prompt with the 
corresponding response from the response file. If the response 
file does not contain answers for all the prompts, LINK displays 
the prompt that does not have a response and waits for a 
response. When you type a legal response, LINK continues the 
link session. For example: 


fun text table care 
/pause/map 
funlist 

colib.lib 


This response file tells LINK to load the four object modules 
named FUN, TEXT, TABLE, and CARE. LINK pauses before 
producing a public symbol map to permit you to swap disks. 
When you press any key, the output files will be named FUN.EXE 
and FUNLIST.MAP. LINK will search the library file COBLIB.LIB 
and will use the default settings for the switches. 
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Sample LINK Session 


= 


This sample shows you the type of information displayed during 
an LINK session. 


In response to the MS-DOS prompt, type: 


link 


The system displays the following messages and prompts: 


Microsoft Object Linker v2.01 

© Copyright 1982, 1983 by Microsoft Inc. 
Object Modules [.0BJ]: 10 SYSINIT 

Run File (I0.EXE]: 


List File (NUL.MAP]: IO /MAP 


Libraries [.LIB_:; 


Notes: 


By specifying /MAP, you get both an alphabetic listing and a 
chronological listing of public symbols. 


By responding PRN to the 
List File: 


prompt, you can redirect your output to the printer. 


By specifying the /LINE option, LINK gives you a listing of 
all line numbers for all modules. (Note that /LINE can 
generate a large volume of output.) 


Appendix C 
LINK Program 


eeeeeeSSSSSSSSSSSSSSSSSSsFseseseseseses 


Once LINK locates all libraries, the linker map displays a list of 
segments in the order of their appearance within the load 
module. The list might look like this: 


Start Stop Length Name 
00000H O009ECH O9EDH CODE 
OO9FOH 01166H 0777H  SYSINITSEG 
The information in the Start and Stop columns shows the 20-bit 


hex address of each segment relative to location zero. Location 
zero is the beginning of the load module. 


The addresses displayed are not the absolute addresses where 
these segments are loaded. See the following section on the 
LINK DEBUG program for information on how to determine the 
absolute address of a segment. 


Because the /MAP option was used, LINK displays the public 
symbols by name and value. For example: 
Address Publics by Name 


009F:0012 BUFFERS 
009F:0005 CURRENT MS-DOS LOCATION 


009F:0011 DEFAULT DRIVE 
009F:000B DEVICE LIST 
009F:0013 PILES 


009F:0009 FINAL MS-DOS LOCATION 
009F:000F MEMORY SIZE 
009F:0000 SYSINIT 
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Address 


oo9oF 


20000 
OO9F: 
OO9F: 
009F: 
OO9F: 
OO9F: 
OO9F: 
OO9F: 


0005 
0009 
000B 
OOOF 
0011 
0012 
0013 


Publics by Value 


SYSINIT 

CURRENT MS-DOS LOCATION 
FINAL MS-DOS LOCATION 
DEVICE LIST 

MEMORY SIZE 

DEFAULT DRIVE 

BUFFERS 

FILES 
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All errors cause the link session to abort. After the cause has 
been found and corrected, LINK must be rerun. The following 
error messages are displayed by LINK: 


Attempt to access data outside of segment bounds, possibly bad 
object module 


There is probably a bad object file. 


Bad numeric parameter 
Numeric value is not in digits. 


Cannot open temporary file 
LINK is unable to create the file VM.TMP because the disk 
directory is full. 


Insert a new disk. Do not remove the disk that will receive 
the LIST.MAP file. 

Error: dup record too complex 
DUP record in assembly language module is too complex. 
Simplify DUP record in assembly language program. 

Error: fixup offset exceeds file width 


An assembly language instruction refers to an address with a 
short instruction instead of a long instruction. 


Edit assembly language source and reassembly. 


Input file read error 
There is probably a bad object file. 
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Invalid object module 


An object module(s) is incorrectly formed or incomplete (as 
when assembly is stopped in the middle). 


Program size or number of segments exceeds capacity of linker 
The total size may not exceed 384 Kb and the number of 
segments may not exceed 255. 


Requested stack size exceeds 64K 
Specify a size greater than or equal to 64 Kb with the 
/STACK option. 


Segment size exceeds 64K 
64 Kb is the addressing system limit. 


Symbol defined more than once 
LINK found two or more modules that define a single symbol 
name. 


Symbol table capacity exceeded 
Very many and/or very long names were typed exceeding the 
limit of approximately 50 Kb. 


Too many external symbols in one module 
The limit is 256 external symbols per module. 


Too many groups 
The limit is 10 groups. 


Too many libraries specified 
The limit is 8 libraries. 
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Too many public symbols 
The limit is 1,024 public symbols. 


Too many segments or classes 
The limit is 256 (segments and classes together total 256). 


Unresolved externals: <list> 
The external symbols listed have no defining module among 
the modules or library files specified. 


VM read error 
This is a disk error; it is not caused by LINK. 


Warning: no stack segment 
None of the object modules specified contains a statement 
allocating stack space, but you typed the /STACK option. 


Warning: segment of absolute or unknown type 
There is a bad object module or an attempt has been made to 
link modules that LINK cannot handle (for example, an 
absolute object module). 


Write error in TMP file 
No more disk space remains to expand the VM.TMP file. 


Write error on run file 
Usually, there is not enough disk space for the run file. 
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Overview 


DEBUG is an executable object program that resides on your 
MS-DOS Supplemental Programs Diskette. DEBUG allows you to: 


* Single step through a program, instruction by instruction, 
to examine registers and for testing purposes. 


° Change register and file contents during the DEBUG 
session so you can test a code change without 
reassembling your program. 


° Make permanent changes to disk files so you can use 
DEBUG to save files that may otherwise be lost. 


¢ Translate machine code instructions into assembly 
language equivalents for testing purposes, with the 
Unassemble command. 
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Terms Used in DEBUG 


Seer 


Address 


Refers to a specific memory location. There are several 
methods of addressing which allow you to point to specific 
memory locations, either directly or via a segment register. 


An address consists of a segment value and an offset value in 
this format: 


segment:offset 


If the colon separator is missing, DEBUG assumes the value is 
an offset and will use either the DS or CS register for the 
segment value, depending upon the command used. 


A segment register may be specified instead of an actual 
segment value like this: 


ES:0090 
All of these are valid address parameters: 


0200 

A03B 
09AC:000A 
3A02:0A11 
DS:0300 
SS:A004 
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Drive 
Refers to a specific drive selection either 0, 1, or 2 depending 
on whether you wish to select drive A, drive B or drive C, 
respectively. For example, to select drive B type: 


1: 


Keyletter 


Refers to the single-letter designation (A,C,D....) for the 
DEBUG command. 


Parameter 
Refers to the additional information following the keyletter 
that specifies exactly what the command is to perform. 
Mostly used to override defaults. Some commands do not 
require parameters and some parameters are optional. 


Range 
Refers to a range of addresses (memory locations). There are 


several formats which can be used to specify the range. 


When you know the start and end addresses, use this format: 
<start address>,<end address> 


When you know the start address and how many locations 
(value) are in the range use this format: 


<start address> L<value> 
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Remember that value must be indicated in hex. For example, 
to address a range of 50 locations starting with 0100 type: 


0100L32 


In both formats, the range represents an offset. Therefore, the 
specified range cannot be greater that FFFF. 


You can also specify a segment address before the range like 
this: 


DS:0300L32 


Value 


Refers to the contents or data of a memory address in a 1- to 
4-character hexadecimal value. 
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How To Start DEBUG 


To start the DEBUG program, type: 


debug [ filename ][,arglist] 


where: 
filename = name of the file to be debugged. 
arglist = optional list of filename parameters and 

options, separated by commas. These will 
be passed to the program specified by the 
filename parameter. 

and: 

[] = optional information. 


When the program is loaded into memory, it is loaded as if you 
had loaded the file without the DEBUG prefix. 


If you enter DEBUG without a filename, you can manipulate 
current memory disk blocks, or disk files since no filename has 
been specified. 


On entering the DEBUG environment, DEBUG responds with the 
hyphen "-" (prompt) and underline "_" (cursor): 


DEBUG 


You may now enter any DEBUG command. 
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The DEBUG session will continue until you type: 


q 
to quit. 


COMMENTS 


If you include the filename in the command line, the specified 
file is loaded into memory starting at address 100H. If you 
specify a file with a .EXE extension, the program is loaded into 
memory starting at the address specified in the header of the 
file. If you specify a file with a HEX extension, the program 
is loaded into memory starting at the address specified in the 
HEX file. HEX files are in INTEL hex format and are 
converted to memory image format by DEBUG. 


When you start DEBUG, it sets up a program segment prefix at 
offset 0 in the program work area. You overwrite this area if 
you enter DEBUG without parameters. Moreover, if you are 
debugging a file with a .COM or .EXE extension, do not 
tamper with the program header below location 5CH, or 
DEBUG will terminate. 


Do not attempt to run a program after the message: 
Program terminated normally 


is displayed. You must reload the program with the Name 
and Load commands for it to run properly. 
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EXAMPLES 
To begin a DEBUG session without loading a file, type: 


debug 


and press RETURN. 


To begin a DEBUG session with the MYPROG file loaded into 
memory from drive B, type: 


debug b:myprog 


and press RETURN. 
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DEBUG Commands 


The DEBUG program commands are summarized in the following 
table and described in more detail in the rest of this appendix. 


Command | Purpose 


A Assembles 8086 microprocessor 
mnemonics directly into memory. 


Cc Compares the contents of two areas of 
memory. 

D Displays an area of memory. 

E Changes the value of consecutive memory 
addresses. 

F Fills a range of memory addresses with 


specified values. 


G Executes the program currently in 
memory, optionally pausing at specified 
addresses to display information about the 
system and program environment. 


HE. Calculates and displays the sum and the 
difference of two hexadecimal values. 
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Command 


Purpose 


Inputs a value from an address 
(input/output port) and displays the 
value. 


Loads a file or absolute disk blocks into 
memory. 


Moves (copies) the values of a specified 
range of memory addresses (source) tu 
another range of memory addresses 
(destination). 


Provides filenames for the Load and Write 
commands or filename parameters for the 
program to be debugged. 


Outputs a value to an address 
(input/output port) and displays the 
value. 


Terminates the DEBUG program. 
Displays the contents of the registers and 


flag settings, with the option to change 
the values. 
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Command 


Purpose 


Ss 


Searches a range of addresses for a 
specified value(s). 


Executes one or more instructions and 
displays the register values, flag settings, 
and the next instructions to be executed. 


Disassembles strings of values in memory 
and displays them as assembler-like 
statements along with their corresponding 
addresses. 


Writes a file or absolute disk blocks to disk 
from memory. 


The following rules apply to the use of DEBUG commands: 


*¢ Commands can be entered in either lowercase or 


uppercase. 


* All commands are entered using the keyletter followed by 
the parameters. Here are some examples: 


d0100,03A0 
c09acLff,0300 
mcs:100,110,cs:500 


Command parameters can be separated from each other by 
spaces or commas for readability but need not be, except 
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where two hexadecimal numbers are entered as 
Parameters, in which case they must be separated by a 
comma or space. For brevity, the syntax of this chapter 
will always indicate a comma where separation is 
obligatory, but note that a space can alternatively be used. 


Commands become effective only after pressing RETURN. 


If you make a syntax error when entering a command, the 
message: 


Error 


will be displayed on the following line. You must re- 
enter the command using the correct syntax. 


Any DEBUG command may be aborted at any time by pressing 
CTRL-C. Pressing CTRL-S suspends the display, so that you can 
read it before the output scrolls away. After suspending the 
display, press any key (except CTRL-S or CTRL-C) to continue 
scrolling. 
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(A)ssemble 
a ee ey 


PURPOSE 


Assembles 8086 microprocessor mnemonics directly into 
memory. 


SYNTAX 
A[address] 


where: 
address = start address into which the subsequently 
entered line of mnemonics is to be 
assembled. 
and: 
[] = optional information. 


If you did not enter an Assemble command previously and the 
address parameter is omitted, location 100 is assumed. If you 
did enter Assemble previously, the code assembles into the 
address following the last instruction loaded by the previous 
Assemble command. 


After you enter the Assemble command, DEBUG displays the 
specified address followed by the cursor. You may then enter 
a line of 8086 microprocessor mnemonics. On terminating the 
line with RETURN, the line will be assembled into memory 
starting at the specified location. The subsequent address to 
the assembled code will be displayed on the next line along 
with the cursor to enable you to enter the next line of code. 
If, instead of a line of 8086 microprocessor mnemonics, you 
simply press RETURN, the Assemble command terminates and 
the DEBUG prompt reappears. 
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a 


COMMENTS 


All values are hexadecimal and must be entered as 1 to 4 
characters. Prefix mnemonics must be specified in front of the 
opcode to which they refer. You may also enter them ona 
separate line. 


The segment override mnemonics are CS, DS, ES, and SS. The 
mnemonics for the far return is RETF. String manipulation 
mnemonics must explicitly state the string size. For example, 
use MOVSB to move byte strings. 


The Assemble command will automatically assemble short, 
near, or far jumps and calls, depending on byte displacement 
with respect to the destination address. These may be 
overridden with the NEAR or FAR prefix. For example: 


0100:0500 jmp 502 ja two-byte short jump 
0100:0502 jmp near 505 ja three-byte near jump 
0100:0505 jmp far 50A ja five-byte far jump 


The NEAR prefix may be abbreviated to NE, but the FAR 
prefix cannot be abbreviated. 


DEBUG cannot tell whether some operands refer to a word 
memory location or to a byte memory location. In this case, 
the data type must be explicitly stated with the prefix WORD 
PTR or BYTE PTR. Acceptable abbreviations are WO and BY. 
For example: 


neg byte ptr [128] 
dec wo [si] 
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DEBUG cannot distinguish whether an operand refers to a 
memory location or to an immediate operand. Enclose 
operands that refer to memory locations in square brackets. 
For example: 


mov ax,21 ;Load AX with 21H 
mov ax,[21] ;Load AX with the contents of 
jlocation 21H 


Two pseudo-instructions are available with the Assemble 
command. The DB opcode will assemble word values directly 
into memory. For example: 


db 1,2,3,4,"this is an example" 
db "this is a quote:" 

db "this is a quote” 

dw 1000,2000,3000,"bach" 


The Assemble command supports all forms of register indirect 
addressing. For example: 


add bx,34{ bp+2].[si-1] 
pop [bp+di] 
push [si] 
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COO 
All opcode synonyms are supported. For example: 


Loopz 100 
Loope 100 
ja 200 
jnbe 200 


EXAMPLE 


To assemble starting at location 200: 
1 Type: 
a200 


and press RETURN. 


DEBUG displays: 


-A200 
09ac:200_. 


2 Type: 
mov ax,[21] 


and press RETURN. 
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The 8086 microprocessor mnemonics are assembled 
starting at location 200. The next address subsequent 
to the assembled code is then displayed: 


-A200 
O09AC:0200MOV Ax, [21] 
09AC:0203_ 


3 Press RETURN. 


The Assemble command terminates and the DEBUG 
prompt reappears. 


-A200 
09AC:0200MoV Ax, [21] 
09AC:0203 
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(C)ompare 


—_ 


PURPOSE 


Compares the contents of two areas of memory. 


SYNTAX 


C <range>, address 


where: 
range — range of addresses defining the first area 
to be compared. If no segment is 
specified, then the entire segment 
specified in the DS register is assumed. 
address = first address of the area to be compared 

with the area specified by the range 
parameter. 

and: 

<> = required information. 


The Compare command compares the area of memory 
specified by the range parameter with an area of the same size 
starting at the address specified by the address parameter. 


COMMENTS 


If the contents of the two areas are identical, nothing is 
displayed. If there are differences, then the differences are 
displayed (per-line) in the format: 


adrs1 cnts1 cnts2 adrs2 
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where: 
adrs1 = address in first area 
cnts1 = contents of adrs1 
adrs2 = corresponding address in second area 
cnts2 = contents of adrs2. 


EXAMPLE 
To compare 100 addresses starting at A500 with 100 addresses 
starting at B200, type: 


ca500,a564,b200 
or 


ca500L64b200 


and press RETURN. 


DEBUG displays: 


-CA500L64,B200 

A502 00A4 00A3 B202 
A503 0001 0000 B203 
A530 O9AA 034C B230 


The display indicates that after comparing addresses 
(locations) A500 through A564 with addresses B200 through 
B264, addresses A502, A503, and A530 were different. 
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(D)isplay 
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PURPOSE 


Displays an area of memory. 


SYNTAX 
D[range] or D[address] 


where: 
range = range of addresses whose contents are to 
be displayed. If you enter only an offset, 
then the segment specified in the DS 
register is assumed. 
address = address from which the display is to start. 

The contents of this address and the next 
127 locations are displayed. 

and: 

[] = optional information. 


COMMENTS 


If D is specified without parameters, then the 128 addresses 
following the last address to be accessed are displayed. If no 
address has yet been accessed, the display will start from 
location DS:100. 


If D and the range parameter are specified, the contents of 
that range of addresses are displayed. If this takes more than 
24 screen lines, the display is scrolled until the contents of the 
final address in the range are displayed on line 24. 
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The address values are displayed (per line) in this format with 
a hyphen (-) between v+7 and v+8: 


adrs v v+1 ... v+15 <ASCv><ASCv+1>...<ASCv+15> 


adrs indicates the address, v its hex value, v+1 the hex value 
of the next address, and so on. ASCv through ASCv+15 
indicate the ASCII characters of the corresponding address. 
The character dot (.) is displayed when the value does not 
have a printable ASCII character. 


Each line displays the hex value and ASCII character for 16 


addresses. The next line starts with the address following the 
v+15 location. 


EXAMPLES 
To display the values of addresses 0100 through 0110, type: 


400,110 


and press RETURN. 


DEBUG displays the address followed by the next 16 
addresses, with a hyphen (-) between addresses 8 and 9, then 
the ASCII character of all 16 addresses, if printable. 


-D0100,0110 
09AC:0100 E8 09 ... 9B-DF ... 01 .... 
09ac:0110 00 
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To display the next 128 addresses, type: 


and press RETURN. 


DEBUG displays: 


20110 
70120 
10130 
10140 
10150 
10160 
10170 
10180 


54 
44 
4F 
48 
4E 
50 
00 
00 


48 
41 
52 
45 
44 
52 
00 
00 


20-54 
43-41 
4D-50 
4c-41 
48-45 
00-00 
00-00 
00-00 


20 
46 
54 
41 
20 
00 
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THIS IS TEXT IN 
DATA LOCATIONS F 
OR A SAMPLE OF T 
HE DISPLAY COMMA 
ND IN THE DEBUG 
PROGRAM... . 
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(E)nter 


$$ 


PURPOSE 


Changes the value of consecutive memory addresses. 


SYNTAX 


E<address> [,value,value+1,. 


where: 


and: 


address = 


value = 


<> = 


= 


address of the location whose value is to 
be changed; or the address of the first of a 
succession of locations whose contents are 
to be replaced. If only an offset is 
specified, then the segment indicated by 
the DS register is assumed. 

data that is to replace the contents of the 
specified address. The contents of the 
memory locations are changed. That is, 
the first value will replace the contents of 
the location specified by the address. A 
second value will replace the contents of 
the location following that specified by 
the address, and so on. 


required information. 
optional information. 
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COMMENTS 


If the command is entered without value parameters, DEBUG 
displays the specified address and its value. This command 
then waits for you to do one of the following: 


° Change the displayed value by entering another value. 
To do this you, type the new value after the current 
value. If you enter an illegal value, or if you type 
more than two digits, the illegal or extra character is 
not echoed. 


Press the SPACE bar to continue to the next address. 
To change this value, simply enter a new value as 
described above. To advance to the next address 
without changing the current value, press the SPACE 
bar again. 


Type: 


- (hyphen) 


to return to the previous address. DEBUG then starts a 
new display line with the address you have returned to 
and its value. You can then change the value of this 
address as described above. To move back one address 
further without changing this value, type: 


- (hyphen) 


again, and another new line will be displayed. You 
can continue back to the address specified in the 
command. 
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If you advance beyond eight addresses on one line, DEBUG 
starts a new display line with the address displayed at the start 
of the line. 

If you specify values, then the first of these values will replace 
the value at the address specified by the address parameter. 


Subsequent values in the command will replace subsequent 
values of addresses in memory. 


EXAMPLES 
To change the value of three consecutive addresses starting at 
address 100: 
1 Type: 


e0100 


and press RETURN. 


DEBUG displays: 


-E0100 
058D:0100 cD._ 


2 Type: 


26 
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The value of address 100, which was CD, is now 
changed to 26. DEBUG then displays: 


-£0100 
058D:0100 CD.26_ 


Press the SPACE bar. 


DEBUG displays the value of the next address (101): 


-E0100 
058D:0100 CD.26 20._ 


Type: 
19 


The value of address 101, which was 20, is now 
changed to 19. DEBUG then displays: 


-E0100 
058D:0100 CD.26 20.19_ 


Press the SPACE bar. 
DEBUG displays the value of the next address (102): 


-E0100 
058D:0100 CD.26 20.19 OA._ 
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6 Type: 
23 


and press RETURN. 


The value of address 102, which was 0A, is now 
changed to 23. The Enter command is terminated 
and DEBUG then displays: 


-£0100 
058D:0100 CD.26 20.19 0A.23 


Another way to change the value of the same three addresses 
is to type: 


e0100,26,19,23 


and press RETURN. 


The values of addresses 100, 101, and 102 which were CD, 20, 
and 0A are now changed to 26,19, and 23. DEBUG then 
displays: 


-£0100,26,19,23 
058D:0100 CD.26 
058D:0101 20.19 
058D:0102 0A.23 
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If you change the first and third addresses and not the second 
address, that is, you pressed the SPACE bar instead of 
changing the second address, the display would look like this: 


-E0100 
058D:0100 CD.26 20. 0A.23 


If you change the first two addresses but change your mind on 
the value in the second address, that is, you typed: 


- (hyphen) 


instead of a new value for the third address, the display would 
look like this: 


-E0100 
058D:0100 CD.26 20.19 OA. 
058D:0101 19._ 
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PURPOSE 


Fills a range of memory addresses with specified values. 


SYNTAX 


F<range> ,value[,value+1,value+2...] 


where: 
range = 


value = 


and: 
<= 


O-= 


COMMENTS 


range of addresses whose values are to be 
changed with the specified values. If only 
the offset is specified, then the segment 
indicated by the DS register is assumed. 

a 2-digit hexadecimal value that is to 
change the value of the specified 
address(es). 


required information. 
optional information. 


If the specified range contains more addresses than the list of 
values, then the list of values is repeated until the specified 


range is filled. 


If a range of six addresses and three values are 


specified, the first and forth, second and fifth, and third and 
sixth addresses will contain the same values. 


If the list of values contains more values then the range has 
addresses, the extra values are ignored. 


D-30 


Appendix D 
DEBUG Program 
(Fill 


—. 


EXAMPLE 
To fill 100 addresses with 00 starting at address 300, type: 


£0300L64,00 


and press RETURN. 


DEBUG displays: 


-F0300L64,00 


The display indicates that addresses 0300 through 0364 (hex 
for 100) now contain 00. 
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PURPOSE 


Executes the program currently in memory, optionally pausing 
at specified addresses to display information about the system 
and program environment. 


SYNTAX 
G[=address][,address...] 


where: 
=address = address in memory at which program 
execution is to start. "="is used to 
distinguish a start address from a pause 
address. 
address = pause address or addresses. You can 

specify up to ten addresses, in any order. 

and: 

[] = optional information. 


If you enter G without parameters, the program currently in 
memory is executed starting from the address specified by the 
CS and IP registers. The program will not pause. 


COMMENTS 


If you specify the =address parameter, the contents of the CS 
and IP registers are changed to those specified by the 
=address parameter and the program in memory is executed, 
starting from the address you specified. 


If you specify one or more pause addresses, program execution 
stops at the first such address encountered and displays the 
contents of the registers, the state of the flags and the next 
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TC 


instruction to be executed (see the Register command 
discussion for a description of the display). 


If only an offset is entered for an address, the command 
assumes the segment in the CS register. 


If you enter more than ten addresses, DEBUG will display: 
BP Error 


Before executing the program, the command changes the value 
of the pause addresses (locations) with an interrupt instruction 
(CC). Then program execution will pause at these addresses. 
DEBUG restores the original values of all the specified 
addresses. However, if the program terminates normally (that 
is, not at a specified address), the original values are not 
restored. 


Note: Once a program has reached completion, you must 
reload the program before you can run it again. 


Each pause address that you specify must point to the first 
address of an 8086 microprocessor instruction, or 
unpredictable results occur. 


The stack segment (SS register) must have six addresses 
available for this command, otherwise unpredictable results 
occur. 
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EXAMPLE 


To run a program starting at address 300 with pauses at 
addresses 303 and 308 (assume program extends beyond 
address 308), type: 


g=0300,0303,0308 


and press RETURN. 


DEBUG displays: 


0300,0303,0308 


AX=0000 BD=0000 Cs=0000 px=0000 
SP=FFFO BP=0000 SI=0000 DI=0000 ps=0000 
ES=0000 CS=0000 IP=013B 

NV UP EI PL NZ NA PO NC 

0000:013B 083D8\ \ \ \ Mov DS,Ax 


AX=0000 BD=0000 Cs=0000 px=0000 
SP=FFFO BP=0000 SI=0000 DrI=0000 ps=0000 
ES=0000 CS=0000 IP=013B 

NV UP EI PL NZ NA PO NC 

0000:013B 083D8\ \ \ \ Mov DS,ax 
Program terminates normally 
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(H)ex Arithmetic 


PURPOSE 


Calculates and displays the sum and the difference of two 
hexadecimal values. 


SYNTAX 


H<value-a>,<value-b> 


where: 
value-a first of two hexadecimal values 
value-b = hexadecimal value that is to be added to 
or subtracted from value-a 
and: 
<> = required information. 
COMMENTS 


The hexadecimal values may be up to four characters long. 
The Hex command displays two 4-digit values; the first is the 


result of adding value-b to value-a and the second is the 
result of subtracting value-b from value-a. 


EXAMPLES 


To determine the sum and the difference of 019F and 010A, 
type: 


hO19F,010a 


and press RETURN. 
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VC esses 
DEBUG displays: 


-HO19F,010A 
02a9 0095 


To determine the sum and the difference of FFFF and 0002, 
type: 


hffff,0002 
and press RETURN. 
DEBUG displays: 


-HFFFF,0002 
0001 FFFD 
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PURPOSE 


Inputs a value from an address (input/output port) and 
displays the value. 


SYNTAX 
I <address> 


where: 
address = address of the port that the value is to be 
input from 
and: 
<> = required information. 


COMMENTS 


The address of the input/output port can be up to 16 bits 
wide. 


EXAMPLE 


To input a value from address (input/output port) 32F8 
(assume address 32F8 is an input port), type: 


132F8 
and press RETURN. 
DEBUG displays: 


-112F8 
0000:12F8 6A 
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(L)oad 


PURPOSE 


Loads a file or absolute disk blocks into memory. 


SYNTAX 


L[address][,drive,block,value] 


where: 
address = 


drive = 


block = 
value = 


and: 


o- 


COMMENTS 


starting address in memory at which the 
file or specified blocks is to be loaded 
from. If only an offset is entered, then the 
segment indicated by the CS register is 
assumed. 

drive from which disk blocks are to be 
loaded. For drive A you must enter 0, for 
drive B you must enter 1, for drive C you 
must enter 2, and so on. 

first of a range of blocks to be loaded from 
the disk specified by the drive parameter. 
number of blocks to be loaded. 


optional information. 


If all parameters are specified, then DEBUG loads blocks of 
information from disk into memory. 


If you specify L with just the address parameter, the file whose 
file control block is correctly formatted at location CS:5C is 
loaded into memory. The file control block at CS:5C is set 
either to the filename specified when the DEBUG command 
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was invoked, or to the filename specified by the most recent 
execution of the Name command. 


If L is specified without parameters, the file is loaded starting 
at address CS:100. 


If L and the address parameter are specified, the file is loaded 
starting at the specified address. In either case, DEBUG sets 
the BX:CX registers to the number of addresses loaded. 


If the file has a .EXE extension, then it is relocated to the load 
address specified in the header of the EXE file. That is, the 
address parameter to the Load command is ignored. The 
header itself is stripped off the EXE file before the file is 
loaded into memory. Thus, the size of the EXE file on disk 
will differ from its size in memory. 


If the file has a .HEX extension, entering the command with 
no parameters causes the file to be loaded starting at the 
address specified within the HEX file. If the address 
parameter, however, is specified, then loading starts at the 
address which is the sum of the address specified and the 
address in the HEX file. 


EXAMPLES 
To load the file MYPROG starting at address 0200: 


1 Type: 


nmyprog 


and press RETURN. 
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DEBUG displays: 


-Nmyprog 


The Name command identifies the filename for the 
Load command. 


2 Type: 
10200 
and press RETURN. 


The file MYPROG is loaded into memory starting at 
address 0200. DEBUG then displays: 


-Nmyprog 
-L0200 


To relocate the file in memory starting at address 0A00, type: 
L0a00 

and press RETURN. 

DEBUG displays: 


-LOA00 
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(M)ove 
ce are 


PURPOSE 


Moves (copies) the values of a specified range of memory 
addresses (source) to another range of memory addresses 
(destination). 


SYNTAX 
M<range>,address 


where: 
range = area of memory whose contents are to be 
moved. If you only enter an offset, the 
segment indicated in the DS register is 
assumed. 
address = start of the destination area. If you only 
entered an offset, then the segment 
indicated by the DS register is assumed. 
and: 
<> = required information. 


COMMENTS 


If the source and destination areas overlap, the move is 
performed without loss of data. 


The contents of the source area are not changed by the move, 
unless the destination area overlaps it. 


If you specify an address as the end of the range, you must 
only enter the offset. The segment specified, or defaulted to, 
in the start address of the range is assumed. 
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EXAMPLE 


To copy the values of 32 addresses starting at address 0300 to 
the area of memory starting at address 0500, type: 


m0300L20,0500 


and press RETURN. 


DEBUG displays: 


-M0300L20,0500 


The 32 addresses specified are copied to memory starting at 
address 0500. 
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PURPOSE 


Provides filenames for the Load and Write commands or 
filename parameters for the program to be debugged. 


SYNTAX 


N<filename1> [,filename2...] 


where: 
filenamel = 


filename2 = 
and: 


<> = 


{l= 


file to be loaded into memory, written to 
diskette, or used as a filename parameter 
to the file currently in memory. 

another filename parameter used by the 

file in memory. 


required information. 
optional information. 


The name command can be used to provide: 


* The name of the disk file to be loaded into memory by 
a subsequent Load command. You can enter the 
DEBUG program without specifying parameters, then 
use this command to name the disk file you wish to 
debug, then load the file into memory using the Load 


command. 


This has the same effect as entering the 


filename as the first parameter to the DEBUG command. 
The file control block for the file to be debugged is set 
up at location CS:5C and the file is loaded. 


The name 


to be assigned to the file currently in 


memory when the file is subsequently written to disk. 
That is, the file is already in memory and the Name 
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command sets up the file control block for the specified 
file at location CS:5C. 


When a Write command is subsequently entered the 
file in memory is written to disk with the filename 
whose file control block is set up at location CS:5C. 


Filename parameters to the file in memory to be 
debugged. The Name command provides filename 
parameters for the program currently in memory. 
These parameters are used by the program in memory 
when the Go command is executed. 


Whatever file control block was set at CS:5C is replaced 
by that of the first such parameter. If a second file 
parameter is specified, its file control block is set up at 
location CS:6C. Only two file control blocks are set up, 
although additional filename parameters may be 
included if required. 


All the filenames specified are placed in a save area at 
CS:81, with CS:80 containing a character count. 
Parameters specified in this way are analogous to 
filenames specified in the argument list to the DEBUG 
command. 


EXAMPLES 
To specify the file MYPROG, type: 


nmyprog 


and press RETURN. 
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DEBUG displays: 


-Nmyprog 


The Load and Write commands can now be used. 


To load the file MYPROG starting at address 0300 and run it: 
1 Type: 
nmyprog 


and press RETURN. 


DEBUG displays: 


-Nmyprog 


2 Type: 
10300 


and press RETURN. 
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The file MYPROG is loaded into memory starting at 
address 0300. DEBUG then displays: 


-Nmyprog 
-L0300 


3 Type: 
g=0300 


and press RETURN. 


DEBUG runs the file MYPROG starting at address 
0300, then displays: 


-Nmyprog 
-L0300 
-G=0300 
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(O)utput 
a Se Oe 
PURPOSE 


Outputs a value to an address (input/output port) and displays 
the value. 


SYNTAX 
O<address>,value 
where: 
address = address of the port that the value is to be 


sent to. 
value = contents to be sent, via the specified 
address a two-digit hexadecimal value to 
be sent to the specified port. 
and: 
<> = required information. 


COMMENTS 


The address of the input/output port can be up to 16 bits 
wide. 


EXAMPLE 
To output the value 3C to address (input/output port) 12F8 
(assume address 12F8 is an output port), type: 


012f8,3¢ 


and press RETURN. 
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DEBUG displays: 


-012F8,3C 
0000:12F8 3c 


Appendix D 
DEBUG Program 
(Qhuit 


(Q)uit 
eeFeFeFeFeFeSeSSSSSSFSSe 
PURPOSE 

Terminates the DEBUG program. 
SYNTAX 


Q 


COMMENTS 


The Quit command terminates the DEBUG program without 
saving the file you are working on. Control is returned to 
MS-DOS command mode. 


EXAMPLE 


To save the file MYPROG on disk and quit the DEBUG 
program: 


1 Type: 
nmyprog 


and press RETURN. 


DEBUG displays: 


-Nmyprog 
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2 Type: 


and press RETURN. 


The file MYPROG is saved on disk. DEBUG then 
displays: 


-Nmyprog 
-W 


3. Type: 
q 


The DEBUG program is terminated and displays: 


-Nmyprog 
-W 

-@ 

> 
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(R)egister 


PURPOSE 


Displays the contents of the registers and flag settings, with 
the option to change the values. 


SYNTAX 
R[name][F] 
where: 
name = register name 
F = flag 
and: 
[] = optional information. 


name is any valid register name whose values are to be 
examined and/or optionally changed. Valid register names for 
the 8086 microprocessor are: 


AX DX SI ES" IP. 
BX “SP: “DI. -SS- PC 
cx BP DS CS 


Note: IP and PC both refer to the Instruction Pointer. 
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The flag (F) settings are to be displayed and optionally 
changed. The flags and their values are: 


Flag Set Clear 
Overflow | OV (yes) NV (no) 
Direction | DN (decrement) | UP (increment) 
Interrupt | EL (enabled) DI (disabled) 
Sign NG (negative) PL (plus) 
Zero ZR (yes) NZ (no) 
Auxiliary | AC (yes) NA (no) 
Carry 
Parity PE (even) PO (odd) 
Carry CY (yes) NC (no) 
COMMENTS 


If you specify R without parameters, then the values of all 
registers are displayed along with the flag settings and the 
next instruction to be executed. For example: 


-R 
AX-058D BD-0000 CS=0000 px=0000 

SP=FFFO BP=0000 SI=0000 DI=0000 ps=058D 
ES=058D CS=058D IP=013B 

NV UP EI PL NZ NA PO NC 

058D:013B 083D8 MOV DS,AX 
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If you specify R with a register name, then DEBUG displays 
the values of that register. The command then waits for you 
to do one of the following: 


* Press RETURN to terminate the Register command 
without changing the value of the displayed register. 


* Change the value of the register by entering the 2-digit 
hexadecimal value, then terminate the Register 
command by pressing RETURN. 


If you specify RF, then the current flag settings are displayed. 
You then do one of the following: 


* Press RETURN to terminate the Register command 
without changing the flag values. 


° Change the setting of one or more flags by entering the 
alternate value of the appropriate flags. The new 
values may be entered in any order, with or without 
delimiters. 


EXAMPLES 


To display all registers and flags without changing any values: 


1 Type: 


and press RETURN. 
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DEBUG displays: 


-R 

AX=058D BD=0000 CS=0000 px=0000 
SP=FFFO BP=0000 SI=0000 DI=0000 ps=058D 
ES=058D CS=058D IP=013B 

NV UP EI PL NZ NA PO NC 

058D:013B 083D8\ \ \ \ Mov DS,Ax 


2 Press RETURN. 


This terminates the command without changing 
values. DEBUG then displays: 


-R 

AX=058D BD=0000 CS=0000 px=0000 
SP=FFFO BP=0000 SI=0000 DI=0000 ps=058D 
ES-058D CS—058D IP—013B 

NV UP EI PL NZ NA PO NC 

058D:013B 083D8\ \ \ \ Mov DS,Ax 


To display and change the SP register to 0000: 
A Type: 


rsp 


and press RETURN. 
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DEBUG displays: 


2 Type: 
0000 


and press RETURN. 


The value of the SP register, which was FFFO, is 
changed to 0000. DEBUG then displays: 


-RSP 
SP FFFO 
-0000 


To display the flag settings only, type: 
rf 

and press RETURN. 

DEBUG displays: 


-RF 
NV UP EI PL NZ NA PO NC 


Appendix D 
DEBUG Program 
(Search 


(S)earch 


STEER 


PURPOSE 


Searches a range of addresses for a specified value(s). 


SYNTAX 
S<range> value[,value+1,value+2,...] 


where: 
range = range of addresses within which the 
search is to be made. If you only enter 
the offset, the segment indicated by the 
DS register is assumed. 
value = value to be searched for. When searching 
for more than one value at a time, the 
values must appear in memory in the 
same order to be a correct match. In this 
case, the DEBUG program indicates the 
address of the first value in the pattern. 
and: 
<> = required information. 
[] = optional information. 


For each occurrence of the value(s) within the specified range, 
DEBUG returns the address of the first value. 


COMMENTS 


If no address is returned, no match was found. 
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EXAMPLE 


To search 256 addresses starting at 0400, for the value 2A, 
type: 


s0400L100,2a 


and press RETURN. 


DEBUG displays: 


-S0400L100,2a 
058D:0408 
058D:042c 
058D:04CA 


The display indicates that addresses 0408, 042C, and 04CA in 
the range 0400 through 0500 contain the value 2A. 
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PURPOSE 


Executes one or more instructions and displays the register 
values, flag settings, and the next instruction to be executed. 


SYNTAX 
T[=address][,value] 


where: 
address = starting address of partial execution 
value = number of instructions to be executed 
and: 
[] = optional information. 


COMMENTS 


If the =address parameter is not specified, execution begins at 
CS:IP. 


If the value parameter is not specified, only one instruction is 
executed. 


The registers and flags are displayed in the same format as 
that of the Register command (without parameters). 
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EXAMPLE 


To execute four consecutive instructions in memory starting at 
address 0200, type: 


t=0200,4 


and press RETURN. 


DEBUG executes the instructions associated with addresses 
0200 through 0203 and displays: 


-T=0200,4 

AX=058D BD=0000 Cs=0000 px=0000 
SP=FFFO BP=0000 SI=0000 DI=0000 Ds=058D 
ES=058D CS=058D IP=013B 

NV UP EI PL NZ NA PO NC 

058D:013B 083D8\ \ \ \ MoV DS,AX 
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PURPOSE 


Disassembles strings of values in memory and displays them 
as assembler-like statements along with their corresponding, 
addresses. 


SYNTAX 
U[range] or U[address] 


where: 
range = range of addresses whose values are to be 
disassembled. If you do not specify the 
segment, then the segment indicated by 
the CS register is assumed. 
address = address of the value which is to be 

disassembled. If you do not specify the 
segment, then the segment indicated by 
the CS register is assumed. 

and: 

[] = optional information. 


COMMENTS 


If you specify U without parameters, then 32 addresses are 
disassembled starting at the address specified by the CS:IP 
register. 


The number of addresses disassembled may be slightly more 
than the number you specified. This is because instructions 
are not always the same length and the final address in a 
range will not always contain the last address of an 
instruction. 
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The first address of a range, or the address parameter, must 
refer to the first address of an 8086 microprocessor instruction, 
otherwise results are unpredictable. 


EXAMPLE 


To disassemble instruction in addresses 0204 through 020B, 
type: 


u0204L8 


and press RETURN. 


DEBUG displays: 


-U0204LB 
058D:0204 8D16DFOD LEA Dx[oOpDF) 
058D:0208 42 INC Dx 
058D:0209 03D0 ADD DX,AX 


058D:020B 8916E50B MOV [OBES] ,Dx 


The display indicates what instructions are located in 
addresses 0204 through 020E. 
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PURPOSE 


Writes a file or absolute disk blocks to disk from memory. 


SYNTAX 


W[address][,drive,block,value] 


where: 
address = 


drive = 


block = 


and: 


Die 


COMMENTS 


start address of the code in memory that is 
to be written to disk. If you enter only an 
offset, then the segment indicated in the 
CS register is assumed. 

drive containing the specified blocks to 
which code in memory is to be written. 
For drive A you must enter 0, for drive B 
you must enter 1, for drive C you must 
enter 2, and so on. 

block number on disk that is the first of a 
contiguous range of blocks to be overwritten 
with code from memory. 

number of disk blocks to be overwritten 
with code from memory. 


optional information. 


If you specify the command without parameters, then the file 
is written to disk starting from memory address CS:100. If you 
specify the address parameter, then the file in memory, 
starting from the specified address, is written to disk. 
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Before executing the command, BX:CX must be set to the 
number of addresses to be written. This value was set up 
correctly when the file was loaded (either by the Load 
command or the DEBUG command itself). However, if, since 
loading the file, you have executed a Go or Trace command, 
then the value of BX:CX have been changed. Be sure this 
value is set up correctly. 


When the command writes a file to disk, it obtains the drive 
specifier and filename via the file control block set up at 
CS:5C. If no drive specifier is set up, then the default is 
assumed. This file control block is set up either by the 
DEBUG command (for the file you specify as a parameter to 
DEBUG) or by a subsequent Name command. If it does not 
indicate the file specifier you require, you must set up this file 
control block using the Name command. 


When the file is written to disk it overwrites the version 
currently on disk unless the specified filename does not exist, 
in which case a new file is created. 


If all parameters are specified, then the code in memory is 
written to the drive specified by the parameter. The data to be 
written starts at the memory location specified by the address 
parameter, and is written to the blocks on the disk specified 
by the block and value parameters. Be extremely careful to 
correctly specify the value, since information stored there 
previously will be destroyed by this operation. 
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EXAMPLE 
To write the file MYPROG to disk starting from location 0200: 


1 


Type: 
nmyprog 


and press RETURN. 


DEBUG displays: 


-Nmyprog 


The Name command identifies the filename for the 
write command. 


Type: 
w0200 


and press RETURN. 


The file MYPROG is written to disk from memory 
starting at address 0200. DEBUG then displays: 


-Nmyprog 
-w0200 


D-64 


Appendix D 
DEBUG Program 
Messages 


Messages 


SO 


BF (bad flag) 
You attempted to alter a flag, but entered some characters that 
are not acceptable pairs of flag values. 


See the discussion of the Register command for the list of 
acceptable flag entries. 


BP (too many breakpoints) 
You specified more than ten breakpoints as parameters to the 
Go command. 


Reenter the command with ten or fewer breakpoints. 
BR (bad register) 


You entered the Register command with an invalid register 
name. 


DF (double flag) 
You entered two values for one flag. 
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What Is a Configuration File? 


In many cases, you may want to add additional devices to your 
system or change the characteristics of the standard devices that 
MS-DOS is designed to use. You inform MS-DOS of these 
changes by writing a configuration file. 


The configuration file, named CONFIGSYS, is simply a file that 
has certain commands for MS-DOS to execute at startup. Each 
time you start MS-DOS, MS-DOS searches the root directory of 
the drive it was started from for a file named CONFIG.SYS. The 
CONFIG.SYS file allows you to customize your system with a 
minimum of effort. For example, you can add a device driver to 
your system at startup by adding a simple command in the 
CONFIG.SYS file. 


Changing the CONFIG.SYS File 


If there is no CONFIG.SYS file on the MS-DOS disk, you can use 
the MS-DOS command copy con config.sys or an editor such as 
EDLIN to create the CONFIG:SYS file and save it on the MS-DOS 
disk in your root directory. MS-DOS will not use the file if it is 
not named CONFIG.SYS and is not located on the root directory 
of your startup disk. 
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MS-DOS always assigns letters to disk drives in the following 
order: 


* A is the first diskette drive. 


* Bis the second diskette drive, if it exists. On single 
diskette /fixed disk systems, A and B refer to the same 
drive. 


* Cis the MS-DOS partition of a fixed disk, if a fixed disk 
exists. Otherwise, this letter can be assigned to another 
device. 


© D, E, and F are the MS-DOS data partitions of a fixed disk, 
if these partitions exist. Otherwise, these letters can be 
assigned to other devices. 


MS-DOS assigns available drive letters to other drives in the 
order in which the drives are encountered: first, up to four 
"internal" diskette drives and up to two "internal" fixed disk 
drives; then, any "external" devices specified in CONFIG.SYS. 
(These are actual physical drives, not RAM disks or drive 
partitions.) The term "internal" does not mean the drives must be 
located inside the system unit; rather, "internal" drives are 
described within certain tables MS-DOS uses to define drives, and 
"external" drives are described outside of these tables. 


If you add or change drives, you'll need to include one or more 
of the following commands in your CONFIG.SYS file: 


Note: If you choose to specify DRIVPARM, it must appear 
before the other listed commands, which are listed in 
recommended order. 
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DRIVPARM changes the characteristics of "internal" 
drives. 

DEVICE=DRIVER.SYS adds and defines your system’s 
"external" drives. This command can also assign two 
different letters to the same drive. 
DEVICE=RAMDRIVE.SYS lets you use part of your 
computer’s memory as a fast, temporary RAM disk. 


LASTDRIVE sets the maximum number of drives that you 
may access. 


For more information, refer to the rest of this appendix, 
Appendix H, DRIVER.SYS, and Appendix I, RAMDRIVE.SYS. 
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The following commands are used in the CONFIG.SYS file: 


Command Purpose 

BREAK Sets CTRL-BREAK check 

BUFFERS Sets the number of disk buffers 

DEVICE Installs a device driver into the 
system 

DRIVPARM | Redefines parameters for 
internal block devices (disk 
drives) 

FCBS Specifies the number of file 
control blocks (FCBs) that can 
be concurrently open 

FILES Sets the number of open files 
that can be accessed by certain 
MS-DOS system calls 

LASTDRIVE | Sets the maximum drive letter 
that you may use 

SHELL Begins execution of the shell 
from a specific file 


These commands are described in detail on the following pages. 
For a sample CONFIG.SYS file, see the end of this appendix. 


ES 
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PURPOSE 

Sets CTRL-BREAK (CTRL-C) check. 
SYNTAX 

BREAK=<(ON} (OFF}> 

where: 


<> 


0 


required information 
either/or. 


COMMENTS 


Depending on the program you are running, CTRL-BREAK 
may be used to stop an activity (for example, to stop sorting a 
file). Normally, MS-DOS only checks to see if CTRL-BREAK 
has been typed while it is reading from the keyboard, writing 
on the screen, or to a printer. Setting BREAK to ON checks 
for CTRL-BREAK before other functions such as disk reads and 
writes. 


EXAMPLE 
break=off 


This is the default value. 
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PURPOSE 


Allows you to set the number of disk buffers that MS-DOS 
allocates in memory at the time you start the system. 


SYNTAX 
BUFFERS = x 


where x = number of disk buffers. 


COMMENTS 


A disk buffer is a 512-byte block of memory where MS-DOS 
can hold data being read from or written to a disk. Increasing 
the number of buffers generally speeds up disk reads and 
writes, but reduces the memory available to applications. 


The default number of buffers is 2. For applications such as 
word processors, a number between 10 and 20 will provide the 
best performance. If you plan to create a lot of subdirectories 
or use database applications, increase the buffer values to 
between 20 and 30. The more buffers you specify, the more 
memory MS-DOS requires. 


EXAMPLE 
buffers =10 
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PURPOSE 
Installs the specified device driver, a machine-language 
program that allows MS-DOS to use a device. The standard 
installable device drivers provided with MS-DOS are: 
 ANSI.SYS (described in Appendix G) 
¢ DRIVER.SYS (described in Appendix H) 
e RAMDRIVE.SYS (described in Appendix 1) 
e AC.SYS (described in Appendix K) 
e VDISK.SYS (described in Appendix L) 


You can include more than one DEVICE command in 
CONFIG.SYS. 


SYNTAX 


DEVICE = [drive:] [path] < filename > 


where: 
drive = drive where device driver file is located 
path = path where device driver file is located 
filename: = name of device driver file 
and: 
<> = required information 
{] = optional information. 
COMMENTS 


When you start MS-DOS, it loads into memory standard 
device drivers for diskette drives, fixed disk drives, standard 
input (the keyboard), standard output (the display screen), and 
standard printers. If your system has a special device 
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connected to it, you must install a device driver for it using the 
DEVICE command. 
EXAMPLE 


If you plan to use the ANSI escape sequences described in 
Appendix G, you should create a CONFIG.SYS file with the 
following command: 


device =ansi.sys 


This command causes MS-DOS to enable keyboard input and 
screen output support for the ANSI escape sequences. 
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PURPOSE 


Allows you to define parameters for "internal" disk drives or 
other block devices when you start MS-DOS, overriding the 
standard MS-DOS device driver settings. 


Note: Do not confuse DRIVPARM with DRIVER.SYS. 
DRIVER.SYS should be used only to add new "external" 
physical drives to your system, or to assign more than one 
drive letter to the same drive. Refer to the section 
Configuring Disk Drives in this appendix. 


SYNTAX 


DRIVPARM = </D:ddd> [/C] [/F:<f>] [/H:<hh>] 
[UN] /S:<ss>][/T: <ttt>] 


where: 
<> 
is] 


required information 
optional information. 


Wow 


OPTIONS 


The ddd parameter on the /D option specifies a logical 
drive number between 0 and 255. 0 refers to drive A, 1 
refers to drive B, and so on. 
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The word "logical" is important here. On a single- 
diskette/fixed-disk system, MS-DOS always assigns 
both logical drive letters A and B to the single diskette 
drive to permit copying files from one diskette in that 
drive to another diskette in that same drive. Similarly, 
MS-DOS assigns separate logical drive letters to the 
MS-DOS and any MS-DOS data partitions on a fixed 
disk, even though the partitions all reside on one 
physical fixed disk. 


The /C option specifies that changeline (doorlock) 
support is required; this option detects whether the 
diskette drive door is open on certain computers. 


The f parameter on the /F option specifies the form 
factor index where: 


0 = 320/360-Kb diskette drive 

1 = 1.2-Mb diskette drive 

2 = 720-Kb diskette drive 

3 = B-inch, single-density, diskette drive 
4 = 8-inch, double-density, diskette drive 
5 = Fixed disk 

6 = Tape drive 

7 = Other. 


If you do not specify the /F option, DRIVPARM uses a 
default of 720 Kb. 


The hh number on the /H option specifies the 
maximum number of read/write heads. Its value can 
range from 1 to 99. 
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* The /N option specifies a nonremovable block device, 
such as a fixed disk or tape drive. 


* The ss number on the /S option specifies the number 
of sectors per track. Its value can range from 1 to 99. 


* The ttt number on the /T option specifies the number 
of tracks per side on the block device. Its value can 
range from 1 to 999. 


COMMENTS 


Setting DRIVPARM overrides any definitions given to block 
device drivers by MS-DOS at startup. If an option is not set, 
the definition set at startup is used. 


EXAMPLE 


Suppose you have a computer with an internal tape drive unit 
on drive E that is configured when you start MS-DOS to write 
20 tracks of 40 sectors per track. If you want to reconfigure 
this tape drive to write 10 tracks of 99 sectors each, you can 
put the following line in your CONFIG.SYS file: 


drivparm=/d:4 /f:6 /h:1 /s:99 /t:10 


This overrides the default device driver settings, and supports 
a tape drive as drive E. This tape drive has one head, and 
supports a tape format of 10 tracks with 99 sectors per track. 
(This assumes that the hardware driver for the tape device 
supports this configuration of tracks and sectors.) You could 
use this method to create a tape that you can read on another 
computer that uses this alternate format. 
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FCBS 


_ _, 


PURPOSE 


Allows you to determine the number of file control blocks 
(FCBs) that can be concurrently open. 


Note: This command is intended for use with MS-DOS 
Version 1.xx software. 


SYNTAX 
FCBS=<x>,<y> 
where: 
x = number of files opened by FCBs that can 
be open at any one time. 
y = number of files opened by FCBs that 
MS-DOS cannot close automatically if an 
application tries to open more than x by 
FCBs. 
and: 


<> = required information. 


COMMENTS 
The default value for x is 4. Allowed values are from 1 to 255. 
The first y files opened by FCBs are protected from being 


closed. The default value is 0. Allowed values are from 0 to 
255. 
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Notes: 
Specifying FCBs increases the size of MS-DOS in memory. 
x must be greater than or equal to y. 


EXAMPLE 
febs=4,2 
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FILES 
es 


PURPOSE 


Sets the number of open file handles that the MS-DOS system 
calls can access. 


SYNTAX 
FILES = <x> 


where: 
x = maximum number of open file handles 
(reads, writes, opens, and closes) that the 
system calls can access concurrently. 
and: 
<> = required information. 


COMMENTS 


x can be any number between 8 and 20. The default value is 
8. Specifying a number greater than 8 increases the size of 
MS-DOS in memory. 


EXAMPLE 
files =20 
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LASTDRIVE 
= 


PURPOSE 


Sets the maximum number of drives that you may access. 


SYNTAX 


LASTDRIVE= <x> 


where: 
x = any letter from A to Z 
and: 
<> = required information. 
COMMENTS 


x can be any letter from A to Z. 


x represents the last valid drive that MS-DOS will accept. The 
default value is E. The minimum number is equal to the 
number of drives you have installed on your computer. 


At startup, MS-DOS recognizes five drive letters, A through E, 
no matter how many physical drives you have on your system. 
LASTDRIVE should be set to a higher drive if you use any of 
the following MS-DOS features: 

e Drive aliases (SUBST) 

e DOS data partitions on a fixed disk drive 

"External" physical drives (DRIVER.SYS) 

e RAMDRIVE or VDISK 

e Network drives. 
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You should note that MS-DOS allocates a data structure about 
100 bytes long for each drive that you specify, increasing the 
size of MS-DOS in memory, so you shouldn’t specify more 
drives than necessary. 


EXAMPLE 


lastdrive=m 


This sets the last drive to drive M. 
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SHELL 
ee 


PURPOSE 


Begins execution of the shell (top-level command processor) 
from a file defined by the specified filename. Use it to 
increase environment space. 


SYNTAX 
SHELL=[drive:][path] <filename> [/E:<nnn>][/P] 


where: 
drive = location of command processor 
path = location of command processor 
filename = name of command processor 
and: 


<> = required information 
[] = optional information. 


OPTIONS 
The /E option specifies the environment size in bytes. 


The /P option tells MS-DOS to make the command processor 
permanent. 


Note: These options may not work with alternative 
command processors. 


COMMENTS 


This command must be used if you are using an alternative 
command processor (instead of the MS-DOS file named 
COMMAND.COM). MS-DOS will start the processor specified 
by filename instead of reading COMMAND.COM. 
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EXAMPLE 
See the next section, Sample CONFIG.SYS File. 
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Sample CONFIG.SYS File 


A typical configuration file might look like this: 


buffers=10 

files=10 

device=\bin\ramdrive.sys 512 

break=on 

shell=a:\bin\command.com a:\bin /e:500/p 


Note that the BUFFERS and FILES commands are set to 10. 
MS-DOS will search for the file \BIN\RAMDRIVE.SYS to find the 
device that is being added to the system. Make sure that you 
place the device file in the path that you specify in the DEVICE 
command. 


This file also sets the MS-DOS command processor to the 
COMMAND.COM file located on disk in drive A in the \BIN 
directory. The A:\BIN tells COMMAND.COM where it can be 
found when it needs to be reread from disk. The /E option sets 
the size of the environment to 500 bytes. The /P option tells 
COMMAND.COM that it is the first program running on the 
system so that it can process the MS-DOS EXIT command. (Refer 
to COMMAND in Chapter 5, MS-DOS Commands, for more 
information on the command processor.) 
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Program Structure and Loading 


TT 


SYNTAX 


EXE2BIN [drive1:][path1] <filename1> 
[drive2:][path2] <filename2> 


where: 
drivel = drive where input file is located 
path1 = path where input file is located 
filenamel = name of input file 
drive2 = drive where output file is to be located 
path2 = path where output file is to be located 
filename2 = name of output file 
and: 
<> = required information 
[] = optional information. 


EXAMPLE 


exe2bin b:prog.exe b:prog.com 


COMMENTS 


In specifying the input file, everything except the filename is 
optional. If you do not specify a drive, the default drive is 
used. If you do not specify a path, the default path is used. If 
you do not specify an extension, the default is EXE. The 
input file is converted to COM file format (memory image of 
the program) and placed in the output file. 


You are not required to enter any part of the output file 
specification. If you do not specify a drive, the drive of the 
input file will be used. If you do not specify an output path 
or filename, the input path or filename will be used. If you do 
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not specify a filename extension in the output filename, the 
new file will be given an extension of .BIN. 


The input file must be in valid .EXE format produced by the 
linker. The resident, or actual code and data part of the file 
must be less than 64 Kb. There must be no STACK segment. 


Two kinds of conversion are possible, depending on the initial 
CS:IP (Code Segment: Instruction Pointer) specified in the 
-EXE file: 


° If CS:IP is specified as 0000:100H, it is assumed that the 
file is to be run as a .COM file with the location pointer 
set at 100H by the assembler statement ORG; the first 
100H bytes of the file are deleted. No segment address 
fixups (that is, instructions that contain a reference to 
an absolute segment address) are allowed, as .COM files 
must be segment relocatable. 


Once the conversion is complete, rename the resulting 
file with a .COM extension. 


The command processor can load and execute the 
program in the same way as the .COM programs 
supplied on your MS-DOS system diskettes. 


If CS:IP is not specified in the .EXE file, a pure binary 
conversion is assumed. If segment fixups are necessary 
(that is, the program contains instructions requiring a 
segment address), you are prompted for the fix-up 
value. This value is the absolute segment at which the 
program is to be loaded. 
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The resulting program is usable only when loaded at 
the absolute memory address specified by your 
application. 


The command processor is not capable of properly 
loading the program. This is the case when writing a 
-BIN program to use in an application such as a device 
driver that is always loaded at the same absolute 
address. 
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Messages 
-:.——SS 


Amount read less than size in header 


The program portion of the file was smaller than indicated 
in the file’s header. 


Reassemble and relink your program. 


File cannot be converted 
CS:IP does not meet the criteria specified above, or it meets 
the .COM file criterion but has segment fixups. This 
message is also displayed if the file is not a valid executable 
file. 


File creation error 
EXE2BIN cannot create the output file. 


Run CHKDSK to determine if the directory is full or if some 
other condition caused the error. 


File not found 
The file is not on the diskette specified. 


Fixups needed — base segment (hex): 
The source (.EXE) file contained information indicating that 
a load segment is required for the file. 


Specify the absolute segment address at which the finished 
module is to be located. 


Insufficient disk space 
There is not enough disk space to create a new file. 


Insufficient memory 
There is not enough memory to run EXE2BIN. 
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WARNING ~— Read error in EXE file 


Amount read less than size in header. 


This is a warning message only. However, it is usually a 
good idea to reassemble and relink your source program 
when this message appears. 
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Overview 


An ANSI escape sequence is a series of characters, beginning with 
an escape character, that you can use to define input and output 
functions to MS-DOS. You can affect cursor movement, change 
graphics functions, and reassign keys. 


There are a variety of applications for the extended keyboard and 
screen support afforded by the ANSI escape sequences. For 
example: 


* You may be engaged in communications with a host 
computer that expects ANSI escape sequences (for 
example, your AT&T PC is emulating an ANSI terminal). 


° You may reassign a function key so that, for example, 
pressing FQ clears the screen. 


* Some applications software that you purchase may make 
use of these sequences. 
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Installing the ANSI.SYS Device Driver 


o—_—_———— um 


To utilize the ANSI escape sequences, load the special device 
driver, ANSLSYS, by placing the following statement in your 
CONFIG.SYS file (refer to Appendix E, CONFIG.SYS, for more 
information): 


device=ansi.sys 


Every time you start MS-DOS, the ANSI.SYS driver will be loaded 
into memory so that you can use the escape sequences. 
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ANSI Escape Sequences 


The rest of this appendix explains how the ANSI escape 
sequences are defined for MS-DOS. Examples of how to use 
ANSI escape sequences are included at the end. 


Notes: 


MS-DOS uses a default value when you do not specify a value 
or when you specify zero. 


Pn represents a "numeric parameter." This is a decimal 
number specified with ASCII digits. 


Ps represents a "selective parameter." This is any decimal 
number that is used to select a subfunction. Multiple 
subfunctions may be selected by separating the parameters 
with semicolons. 


Pl represents the "line parameter." This is a decimal number 
specified with ASCII digits. 


Pc represents the "column parameter." This is a decimal 
number specified with ASCII digits. 


ESC is the 1-byte code for the escape character (hexadecimal 
1B). 
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Cursor Functions 


The following escape sequences affect the cursor position on the 
screen: 


Cursor Position (CUP) 
ESC[P1;PcH 


Horizontal and Vertical Position (HVP) 
ESC[P1;Pcf 


Either of these sequences moves the cursor to the position 
specified by the parameters. The first parameter specifies the line 
number, and the second parameter specifies the column number. 
The default value is 1. When no parameters are specified, the 
cursor moves to the home position. 


Cursor Up (CUU) 
ESC[PnA 


This sequence moves the cursor up one line without changing 
columns. The value of Pn sets the number of lines moved. The 
default value for Pn is 1. MS-DOS ignores the sequence if the 
cursor is already on the top line. 


Cursor Down (CUD) 
ESC[PnB 


This sequence moves the cursor down one line without changing 
columns. The value of Pn sets the number of lines moved. The 
default value for Pn is 1. MS-DOS ignores the sequence if the 
cursor is already on the bottom line. 


Appendix G 
ANSLSYS 


Cursor Forward (CUF) 
ESC[PnC 


This sequence moves the cursor forward one column without 
changing lines. The value of Pn sets the number of columns 
moved. The default value for Pn is 1. MS-DOS ignores the 
sequence if the cursor is already in the far right column. 


Cursor Backward (CUB) 
ESC[PnD 


This sequence moves the cursor back one column without 
changing lines. The value of Pn sets the number of columns 
moved. The default value for Pn is 1. MS-DOS ignores the 
sequence if the cursor is already in the far left column. 


Device Status Report (DSR) 
Esc[6n 


The console driver will output a CPR sequence (see Cursor 
Position Report below) on receipt of the DSR escape sequence. 


Cursor Position Report (CPR) 
ESC[Pn;PnR 


This sequence causes the console driver to report the current 
cursor position using standard input. The first parameter specifies 
the current line and the second parameter specifies the current 
column. 
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Save Cursor Position (SCP) 
ESC[s 


The current cursor position is saved. This cursor position can be 
restored with the RCP sequence (see Restore Cursor Position 
below). 


Restore Cursor Position (RCP) 
ESC[u 


This sequence restores the cursor position to the value it had 
when the console driver received the SCP sequence. 


Erase Functions 


The following escape sequences affect erase functions: 


Erase Display (ED) 
ESC[2J 


This sequence erases the screen and the cursor goes to the home 
position. 


Erase Line (EL) 
ESC[K 


This sequence erases from the cursor to the end of the line 
(including the cursor position). 
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Display and Graphics Modes 


The following escape sequences affect screen graphics: 


Set Graphics Rendition (SGR) 
ESC[Ps;...;Psm 


This sequence calls the graphic functions specified by the 
parameters described below. The graphic functions remain until 
the next occurrence of an SGR escape sequence. 


Parameter | Parameter Function 
0 All attributes off 
(white on black) 

1 Bold on (high intensity) 

2) Faint on (low intensity) 

3 Italic on 

5 Blink on 

6 Rapid blink on 

7 Reverse video on 

8 Concealed on (invisible) (ISO 6429 standard) 
30 Black foreground (ISO 6429 standard) 
a Red foreground (ISO 6429 standard) 
32 Green foreground (ISO 6429 standard) 
33 Yellow foreground (ISO 6429 standard) 
34 Blue foreground (ISO 6429 standard) 
35 Magenta foreground (ISO 6429 standard) 
36 Cyan foreground (ISO 6429 standard) 
37 White foreground (ISO 6429 standard) 
40 Black background (ISO 6429 standard) 
41 Red background (ISO 6429 standard) 
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Parameter | Parameter Function 
42 Green background (ISO 6429 standard) 
43 Yellow background (ISO 6429 standard) 
44 Blue background (ISO 6429 standard) 
45 Magenta background (ISO 6429 standard) 
46 Cyan background (ISO 6429 standard) 
47 White background (ISO 6429 standard) 
48 Subscript 
49 Superscript 
Set Mode (SM) 
ESC[=Psh (sets parameter to 0 through 7) 

or ESC[=h (sets parameter to 0 only) 

or ESC[=0h (sets parameter to 0 only) 

or ESC[?7h (sets parameter to 7 only) 


This sequence changes the screen width or type to one of the 


following: 


Parameter 


Parameter Function 


NauMnRUNnHo 


40 x 25 black and white 
40 x 25 color 

80 x 25 black and white 
80 x 25 color 

320 x 200 color 

320 x 200 color 

640 x 200 black and white 
wrap at end of line 
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Reset Mode (RM) 


ESC[=Psl (sets parameter to 0 through 7) 
or ESC[=1 (sets parameter to 0 only) 
or ESC[=01 (sets parameter to 0 only) 
or ESC[?71 (sets parameter to 7 only) 


Note: All four codes end with a lower-case L. 


Parameters for RM are the same as for SM, except that 
parameter 7 will reset the wrap at the end of line mode. 
Characters at the end of the line will be thrown away. 


Keyboard Key Reassignment 


Although not part of the ANSI 3.64-1979 or ISO 6429 standard, 
the following keyboard reassignments are compatible with these 
standards. 


The control sequence is: 


ESC[Pn;Pn;...Pnp 

or ESC[Pn;'string";Pn;Pn;'string";Pn p 

or any other combination of strings and decimal 
numbers beginning with ESC[ and ending with a 
lower-case P. 


The final code in the control sequence (p) is one reserved for 
private use by the ANSI 3.64-1979 standard. 


The first ASCII code in the control sequence defines which code 
is being mapped. The remaining numbers define the sequence of 
ASCII codes generated when this key is intercepted. Note that 
there is one exception: If the first code in the sequence is zero 
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(NUL), then the first and second code make up an extended ASCII 
redefinition. Extended ASCII is used to reassign function keys 
and keys pressed with SHIFT, CTRL, and ALT where the key code 
falls outside the ASCII character set. See the chapter on ROM 
BIOS Service Routines in your computer's system programmer's 
guide for more information. 


Examples 


To reassign the Q and q key to the A and a key, and vice versa, 
type: 


ESC[65;8lp A becomes Q 
ESC[97;113p a becomes q 
ESC[81;65p Q becomes A 
ESC[113;97p q becomes a 


To reassign the F1 key to a DIR command followed by a carriage 
return, type: 


ESC[0;68;"dir";]3p 


The 0,68 is the extended ASCII code for the F10 key; 13 decimal 
is a carriage return. The quote marks are not mapped to the key. 


DRIVER.SYS 
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What Is DRIVER.SYS? 


DRIVER.SYS is an installable device driver provided with 
MS-DOS that lets you access more than four diskette drives and 
two fixed disk drives. It supports "external" drives. "External" 
does not mean “outside the system unit"; rather, it means that 
these drives must be defined in a space outside certain tables 
normally used by MS-DOS to define drives. 


Note: Do not confuse DRIVER.SYS with the DRIVPARM 
command in CONFIG.SYS. DRIVER.SYS is only necessary if 
you add more than four diskette drives or two fixed disks to 
your system. These are actual physical drives, not RAM disks 
or drive partitions. DRIVER.SYS tells MS-DOS that these 
additional devices exist and describes their characteristics. In 
addition, DRIVER.SYS may be used to assign more than one 
drive letter to the same drive. On the other hand, 
DRIVPARM is used to change the characteristics of a device 
that MS-DOS already recognizes. 
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Installing DRIVER.SYS 


To install DRIVER.SYS, place the following command line in your 


CONFIG.SYS file (refer to Appendix E, CONFIG.SYS, for more 
information): 


DEVICE=driver.sys </D:ddd>[/C][/F:<f>]/H:<hh>] 
[/N][/S:<sss>][/T:<ttt>] 


where: 


Options 


<> = required information 
[] = optional information. 


The ddd parameter on the /D option specifies a physical | 
drive number between 0 and 255. Physical drives are 
numbered differently than logical drives. Diskette drives 
are numbered starting at 0, and fixed disk drives are 
numbered starting at 128. 


For example, if you have a computer with two diskette 
drives, they are numbered 0 and 1. If you add a third 
diskette drive, its physical drive number is 2. 


If you have a computer with one diskette and one fixed 
disk drive, the diskette drive is number 0, but the fixed 
disk drive is number 128. If you add another diskette 
drive, its physical drive number is still 2, because MS-DOS 
already knows the definitions of physical drives 0 and 1. 


The /C option specifies that changeline (doorlock) support 
is required; this option is used to detect whether the door 
to a diskette drive is open on certain computers. 
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* The f number on the /F option specifies the form factor 
index where: 


0 = 320/360-Kb diskette drive 

1 = 1.2-Mb diskette drive 

2 = 720-Kb diskette drive 

3 = 8-inch, single-density diskette drive 
4 = 8-inch, double-density diskette drive 


5 ixed disk 
6 = Tape drive 
7 = Other. 


If you do not specify the /F option, DRIVER.SYS uses a 
default of 720 Kb. 


The hh number on the /H option specifies the maximum 
number of read/write heads. Its value can range from 1 to 
99. 


The /N option specifies a nonremovable block device, such 
as a fixed disk or tape drive. 


The ss number on the /S option specifies the number of 
sectors per track. Its value can range from 1 to 99. 


The ttt number on the /T option specifies the number of 
tracks per side on the block device. Its value can range 
from 1 to 999. 


You can include more than one DEVICE=DRIVER.SYS command 
in CONFIG.SYS to reference more than one external drive. 
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Examples 


If you want to add an external 720-Kb drive to your computer, 
you would include the following line in your CONFIGSYS file: 


device=driver.sys /d:02 


You can assign two drive letters to the same drive by including 
the previous line twice, as follows: 


device=driver.sys /d:02 
device—driver.sys /d:02 


This lets you use the DISKCOPY command with a single 
"external" 720-Kb drive. 
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What Is RAMDRIVE.SYS? 


RAMDRIVE.SYS is an installable device driver provided with 
MS-DOS that lets you use a portion of your computer's memory 
as if it were a disk drive. This memory area is called a RAM disk 
and is sometimes referred to as a virtual disk. It is referenced by a 
drive letter and you can use it to store files (as long as the RAM 
disk exists in memory). You can have one or more RAM disks. 


RAM disks are much faster than disk drives because the 
information they contain is always loaded into memory. Thus, a 
RAM disk is useful with programs that read from and write to a 
disk frequently. By placing application programs and data in a 
RAM disk, program operation can be sped up. A RAM disk built 
in either expanded or extended memory has the benefit of 
increased speed for program execution while not consuming 
conventional memory. 


However, if the computer loses power, or MS-DOS needs to be 
restarted, the data in the RAM disk is wiped out instantly. Never 
keep the only copy of valuable data in a RAM disk. Save your 
work to a physical disk as often as you can. 


A RAM disk is formatted when it is created. You can use it 
immediately after your system has booted. The data in the RAM 
disk is temporary. When you reboot the system or turn power 
off, the information in the RAM disk is lost. You must copy the 
contents of a RAM disk to either a fixed disk or diskette to retain 
the information. 


A RAM disk can be located in one of four main areas of memory: 


© Conventional memory is the memory range between 0 and 
640 Kb. This is the standard 640 Kb that is usually 
referenced when talking about MS-DOS memory 
limitations. 
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° Expanded memory is memory that is made available 
beyond the 640-Kb limit by the use of a plug-in memory 
card such as the AT&T Enhanced Memory Expansion 
Board. This board may contain from 256 Kb to 2 Mb in 
increments of 256 Kb. 


Extended memory is the continuation of conventional 
memory from 1 Mb to the 16-Mb addressing limit of a 

PC 6300 PLUS. (The memory between 640 Kb and 1 Mb is 
reserved for other tasks.) This type of memory is only 
available on the PC 6300 PLUS. 


Upper extended memory is the top 384 Kb of memory ina 
PC 6300 PLUS that is fully configured with 1 Mb of 
memory on its main circuit board and any amount of 
extended memory between 1 Mb and 16 Mb. This type of 
memory is only available on the PC 6300 PLUS. 
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Installing RAMDRIVE.SYS 


To install RAMDRIVE.SYS, place the following command line in 
your CONFIG:SYS file (refer to Appendix E, CONFIG.SYS, for 
more information): 


DEVICE=RAMDRIVESSYS [bbb] [sss] [dddd] [{/E} {/A} {/U}] 


where: 

bbbb = disk size in Kb. Default value is 64; 
minimum is 16; and maximum is 4,096 
(4 Mb). 

sss = sector size in bytes. Default value is 128; 

allowed values are 128, 256, and 512. 

dddd = number of root directory entries. Default 
value is 64; minimum is 16; and maximum 


is 1,024. 
and: 
[{] = optional information. 
{} = either/or. 
Options 


The /E option installs RAMDRIVE in extended memory (for use 
on the PC 6300 PLUS only). Information on RAMDRIVE disks in 
extended memory will be lost at system reboot (warm or cold). 
There is 1 Kb of memory unavailable for use, regardless of the 
number of RAMDRIVE volumes installed in extended memory. 


The /A option installs RAMDRIVE in expanded memory. If the 
AEMM.SYS device driver is not present, no RAM disk will be 
built. (The AEMM.SYS driver is included with the AT&T 
Enhanced Memory Expansion Board.) Information in the 
RAMDRIVE disks in expanded memory will be lost at reboot 
(warm or cold). 
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The /U option installs RAMDRIVE in upper extended memory. It 
is an error to use this option if the machine is not a PC 6300 
PLUS fully configured with 1 Mb of memory on the main circuit 
board. No more than 384 Kb of RAMDRIVE size can be specified 
and information will be lost on a system reboot (warm or cold). 
As for the /E case, 1 Kb is devoted to system overhead, regardless 
of the number of such disks installed. 


Note: You cannot use the /U option with Simul-Task. 


No Option specifies that the disk is to be set up in conventional 
memory. There is 1 Kb of memory unavailable for use. 
Information will be lost on a system reboot (warm or cold). 


Only one option may be selected for any RAMDRIVE, but more 
than one RAMDRIVE may be installed. 


EXAMPLES 


If you have the AT&T Enhanced Memory Expansion Board 
installed in a PC 6300 PLUS with 2 Mb of additional memory and 
optioned as 1 Mb of extended memory and 1 Mb of expanded 
memory, you could create three RAMDRIVEs with the following 
commands in your CONFIG.SYS file: 


device=aemm.sys 

device=ramdrive.sys 512 /A 
device=ramdrive.sys 1024 /E 
device=ramdrive.sys 384 /U 
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These commands will create a 512-Kb RAM disk in expanded 
memory, a 1-Mb RAM disk in extended memory, and a 384-Kb 
RAM disk in upper extended memory. 


Note: If you create a RAMDRIVE in expanded memory, the 
DEVICE=RAMDRIVE.SYS nnn /A command must 
immediately follow the DEVICE=AEMM.SYS command. 


As each RAMDRIVE is built, the following message will appear: 


Microsoft RAMDrive version 1.16 virtual disk d: 
Disk size: bbbbk 
Sector size: ssss bytes 
Allocation unit: aaaa sectors 
Directory entries: dddda 


next disk drive designation. 

size of the RAM disk built. 

number of bytes per sector. 

size of the allocation unit in sectors. This 
is the number of sectors that will be 
transferred on the disk read or write. 
dddd = number of entries available in the RAM 
disk root directory. 


ASCII Character Values 


ASCII Character Values 


Character 
(null) 


>>? @O 


(beep) 

a 

(tab) 

(line feed) 
(home) 

(form feed) 
(carriage return) 


fp mute peace THO 


(cursor right) 
(cursor left) 
(cursor up) 
(cursor down) 


Control 
character 
NUL 
SOH 
STX 
ETX 
EOT 
ENQ 
ACK 
BEL 
BS 
HT 
LF 
VT 
FF 
CR 
so 
si 
OLE 
oc1 
oc2 
O0c3 
Deca 
NAK 
SYN 
ETB 
CAN 


SUB 
ESC 


047 


Character 


(space) 
! 


OMYHHRWNAONr: 


070 


072 
073 
074 


Character 


| Pm" TNxxE<CHYUDOVOZErF AH -THAAMDOaD® 


ASCII Character Values 


Character 


mew 47900335 


c 


ASCII Character Values 


ASCII ASCII 

value Character value Character 
128 Cc 160 Fy 
129 u 161 ‘ 
130 é 162 6 
131 a 163 é 
132 a 164 a 
133 a 165 N 
134 3 166 @ 
135 ¢ 167 ° 
136 e 168 « 
137 é 169 = 
138 é 170 

139 i 71 % 
140 i 172 % 
141 i 173 f 
142 A 174 « 
143 \ 175 » 
144 E 176 Re 
145 e 177 

146 A 178 

147 3 179 | 
148 ° 180 4 
149 8 181 4 
150 3 182 4 
151 u 183 = 
152 y 184 = 
153 oO 185 2 
154 U 186 I 
155 ¢ 187 = 
156 £ 188 2 
157 ¥ 189 a 
158 Pr 190 = 
159 f 191 ~ 


Character 


baeewrtirdite 


RR | wal 


erdadd 


Pe CH Han 


ASCII Character Values 


Character 


FOSSA POITRMABTH HS OA TAMA THR 


eu 


(blank ‘FF*) 
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What Is AC.SYS 


AC.SYS is an installable device driver provided with MS-DOS 
that lets you use a portion of random access memory as a disk 
cache for the hard disk drive(s). A disk cache is an area of 
random access memory where the most frequently used sectors of 
the disk are stored so that they may be called up without 
accessing the disk. This allows accessing of information much 
faster, particularly when an application uses the disks on the 
same sector repeatedly. 


AC.SYS provides a cache for data being read, not for data being 
written. When data is written, the disk is updated. However, if 
the data sector is being cached, the cache is also updated. This 
means that data read from cache is always consistent with the 
data on the disk. 
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Installing AC.SYS 


1 


AC.SYS is a device driver that must be declared in the 
CONHIG.SYS file. Make AC.SYS the first device declaration in 


the CONFIG.SYS file (refer to Appendix E, CONFIG.SYS, for 
more information). 


AC.SYS is a file included in your MS-DOS diskettes and must be 
present in the root directory of your system disk. To install 
AC.SYS, place the following command in your CONFIG.SYS file: 


DEVICE=AC.SYS [bbbb] [/E] [/Rn] 


where: 
bbbb = Specifies the disk cache size in Kb. If you 
do not include the /E option, you can 
specify a value from 50 Kb through 256 Kb 
for memory below 640 Kb. If you include 
the /E switch, you can specify from 50 Kb 
through 15360 Kb. The default value in 
both cases is 50 Kb. 
and: 
{1 = optional information 


OPTIONS 


The /E option specifies that AC.SYS use extended memory. 
MS-DOS can directly address only 640 Kb. (Random access 
memory installed over 640 Kb is "extended memory.") 


Note: The /E option is only available on computers with 
80286/80386 processors. 


The /Rn option specifies the minimum number of sectors that 
are transferred to cache memory. The value of n is 2, 4, or 8. 
The default value is 4. 
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i, se, 
COMMENTS 


When using AC.SYS, it is recommended that you place the 
command. 


BUFFERS =10 


in your CONFIG.SYS file. A higher value is not needed 
because AC.SYS provides additional buffering for reading the 
hard disk. 


AC.SYS will not work efficiently unless the file being read is 
contiguous on disk (that is, the file is not fregmented). Use 
the command 


CHKDSK *.* 


to find out whether the files in the current directory are 
contiguous. If they are not, optimize the disk layout using the 
BACKUP and RESTORE commands, or some other program 
that makes files contiguous on disk. 


Warning: In a network environment, AC.SYS may cause 
lost interrupts if the /E option was specified (when the 
cache is in extended memory). If this occurs, respecify 
AC.SYS without the /E option. 


The following situations cause VDISK to fail to install: 


e less than 62 Kb free memory for the default settings or 
less than sufficient memory for the cache size chosen. 


e using the /E option with no or insufficient extended 
memory. 
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These situations cause the following error message to display 
on the screen: 


Not enough memory for specified size 
AC.SYS not installed 


EXAMPLES 


On a machine without extended memory, enter the following 
in your CONFIG.SYS file: 


DEVICE=AC.SYS 


This statement uses the default settings to set up a disk cache 
of 50 Kb in normal memory, transferring 4 sectors at a time. 


On a machine with extended memory, place the following in 
your CONFIG.SYS file: 


DEVICE=AC.SYS 1000 /E /R8 


This statement sets up a disk cache of 1000 Kb (with room to 
hold 2000 5/2 Kb sectors) in extended memory, transferring 8 
sectors at a time. 


Reboot your computer A message, such as the following will 
be displayed: 


Resident part of AC.SYS 1.00 installed 
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VDISK.SYS 


What Is VDISK.SYS?. 


Installing VDISK.SYS 
Options... 


Comments 
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What Is VDISK.SYS 


ees 


VDISK.SYS is an installable device driver provided with MS-DOS 
that enables a virtual disk drive with the next available drive 
letter. For example, if you have a two-drive machine with two 
physical drives A: and B:, when VDISK.SYS is installed, you will 
have an extra drive C:. The only difference between virtual disk 
and real disk is that when you turn the machine off, the 
information on the virtual disk is lost. Therefore, remember to 
COPY all files from virtual to real disk before turning off the 
machine. 


L-2 


Appendix L 
VDISK.SYS 


Installing VDISK.SYS 


eee 


VDISK.SYS is a device driver that must be declared in the 
CONFIG.SYS file. The VDISK.SYS file is included on your MS- 
DOS diskette. To install VDISK.SYS, place the following 
command in the CONFIG.SYS file: 


DEVICE = VDISK.SYS[bbbb] [sss] [eeee] [/E{:max}] 


where: 
bbbb = specifies the virtual disk size in Kb. The 
minimum value you can specify is 16; the 
maximum is determined by the amount of 
free memory on your computer. The 
default value is 64 Kb. 


sss = specifies the sector size in bytes. The 
value may be 128, 256, or 512. The default 
value is 128 bytes. 


eee = specifies the maximum number of entries 
allowed in the root directory of the virtual 
disk. The minimum value is 16; the 
maximum is 1024. The default value is 64. 
and: 
(] = options 
{} = either/or 


OPTIONS 


The /E option specifies that VDISK.SYS install a RAM disk in 
extended memory. The :max parameter specifies the 
maximum number of sectors (sector size as specified by "sss") 
to be transferred to/from extended memory. You can specify a 
value in the range of 1 through 8. The default value is 8. If 
you omit /E, VDISK.SYS installs a RAM drive in conventional 
memory (between 0 and 640 Kb). 
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COMMENTS 


In order for the RAM disk to be built in expanded memory, 
enter the following statement in your CONFIG.SYS file before 
the DEVICE =VDISK.SYS /E statement: 


DEVICE = [drive:] [path] AEMM.SYS 


The AEMM.SYS driver is included with the AT&T Enhanced 
Memory Expansion Board. 


Before you install VDISK.SYS, keep in mind the following: 


e You can specify more than one virtual disk. 


Virtual disks are faster than physical disks because data 
is always loaded in memory. 


e MS-DOS assigns the virtual disk the next available 
drive letter designation during the install procedure in 
the CONFIG.SYS file and automatically formats the 
disk after installation. 


e The data on a virtual disk is temporary. If you want to 
save the data, copy it to the fixed disk or a floppy 
diskette. If you do not save the data, it will be erased 
when you reboot the system or turn it off. 
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+* 


A filename abbreviation for "all files on the current or 
specified disk or directory." This abbreviation is often 
used in commands; for example, copy a:*.* b: means 
“copy all files from the disk in drive A to the disk in 
drive B." 


Abort 


To end the program or command currently being 
executed. 


Application Software 
Programs that perform a particular task such as word 
processing or database management. Application software 
is normally distributed on diskettes. 


Attributes 
The characteristics of interest for a file or a directory. In 
MS-DOS, these characteristics normally refer to a file’s 
system, read-only, or hidden attributes. You can change a 
file’s attributes using the CHMOD command. 


AUTOEXEC.BAT 
A batch file that is used to execute a series of commands 
automatically whenever your system is started or restarted. 
The AUTOEXEC.BAT file must reside in the root directory 
of the start-up disk. 


Backing Up 
Archiving files using the BACKUP command. Backing up, 
in general, protects you from loss or destruction of 
original data. 
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Batch Files 


Bit 


Boot 


Byte 


Text files that contain a sequence of commands. Batch files 
enable you to perform repetitive tasks using a single 
command. Batch files can contain MS-DOS commands 
(described in Chapter 5) and batch processing commands 
(described in Chapter 6). They should be named with a 
-BAT extension. 


The smallest possible unit of information. "Bit" is an 
abbreviation for "binary digit." A bit can have two values, 
Oorl. 


The term "booting the system" is often used to refer to the 
action of loading a copy of MS-DOS into your computer's 

memory. In other words, to boot a system is to get it ready 
to use. 


A unit of measurement often used to measure file size or 
amount of memory. A byte is the amount of information 
needed to express one character. A byte consists of eight 
bits. 


Category 


In the Help facility, this term refers to the group of 
subjects (topics) pertaining to a similar theme on which 
help information is available. 


Command 


A program that tells MS-DOS how to perform a specific 
task, such as COPY or DIR. Commands can be internal or 
external. Internal commands reside in memory and can be 
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used at any time from the MS-DOS prompt. External 
commands reside on the MS-DOS System Diskette or the 
MS-DOS Supplemental Programs Diskette. If you have 
not copied the external commands from these diskettes 
onto your fixed disk, one of these diskettes must be in the 
disk drive for you to use external commands. 


COMMAND.COM 
An MS-DOS system file referred to as the command 
processor. This file contains the internal commands and acts 
as an interface between you and MS-DOS. 


Concatenate 
To combine one or more existing files into a single file. 


Configure 
To set up your computer system in a particular way. 


CONFIG.SYS 
A text file, often referred to as the configuration file, that 
contains instructions enabling MS-DOS to recognize 
devices you have connected to your computer. The 
CONFIG.SYS file must reside in the root directory of the 
start-up disk. 


Control Key 
A key that allows you to perform special commands. This 
key is usually abbreviated as CTRL. To use the control key, 
press and hold it while you press another key. This action 
is referred to as a control key sequence. For example, 
CTRL-S stops the screen display from scrolling; CTRL-C 
stops a command from executing. 
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COPY 


An MS-DOS command that copies one or more files from 
one disk or directory to another disk or directory. 


Current Drive 
See Default Disk Drive. 


Cursor 
A symbol (normally a blinking underline) that indicates 
where the next data entry will appear on the display 
screen. 


Cylinder 
A set of tracks on the platters of a fixed disk. Storage space 
on a fixed disk is usually defined by the number of the 
disk’s cylinders. 


Data 
Items of information. 


Data File 
A type of file that contains information used by programs. 


Default Disk Drive 
The drive that is designated by the letter in the MS-DOS 
prompt. For example, A> tells you that the default disk 
drive is A. MS-DOS searches for files in the default disk 
drive unless you specify a different drive. The default disk 
drive is often referred to as the current drive. 


DEL 
An MS-DOS command that deletes one or more files. (DEL 
and ERASE both delete files.) 
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Device Driver 


An interface program that enables communication 
between a peripheral device (such as a modem, a mouse, a 
printer, or a disk drive) and the operating system 
(MS-DOS). Device drivers must be listed in the 
CONFIG.SYS file. 


Device Error 


DIR 


An error that may occur when MS-DOS attempts to read 
or write to a peripheral device such as a modem, a printer, 
a disk drive, or the display screen. 


An MS-DOS command that displays a directory listing of 
the disk in the default drive or the default directory. 
Directory listings display the files and subdirectories 
contained in the default drive or directory along with the 
amount of space used by each file. 


Directory 


Disk 


A collection of files on a diskette or fixed disk. All 
MS-DOS files must be contained in a directory. All 
diskettes and fixed disks formatted for MS-DOS must have 
a main directory called the root directory, which may 
contain files and other directories. These other directories 
may, in turn, contain other files and directories. Typically, 
a diskette contains a single directory, and a fixed disk 
contains multiple directories arranged in a hierarchical 
structure which helps you to organize files. 


See Diskette and Fixed Disk. 
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Disk Operating System 
A set of programs (such as MS-DOS) that acts as an 
interface between you and your computer. A disk 
operating system translates your commands to the 
computer so that you can perform tasks such as creating 
files, running programs, and printing documents. 


DISKCOPY 
An MS-DOS command that copies the contents of an 
entire diskette to another diskette of the same type. 


Diskette 
A small disk containing magnetic media that stores 
information. Diskettes are sealed in protective covers 
(jackets). Also called a floppy disk. 


Diskette Drive 
A device, usually built into your computer, that allows 
your computer to read information from, and write 
information to, diskettes. You must insert diskettes into 
the diskette drive so that your computer can read or write 
information on the diskettes. 


DOS Data Partition 
The part of the fixed disk that cannot contain a working 
copy of the MS-DOS operating system, but can contain 
MS-DOS programs and data. 


Drive Name 
A name for a diskette or fixed disk drive. Drive names tell 
MS-DOS which drive to search for a specified file. Drive 
names consist of a letter and a colon. For example, diskette 
drives are referred to as drive A and drive B. Fixed disk 
drives are normally referred to as drive C. 
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Driver 
See Device Driver. 


Editor 
A program that allows you to type text and data into the 
computer. Most editors enable you to move, add, and 
delete characters and lines and to save files. With line 
editors, you can only process text one line at a time. Other 
editors, referred to as screen editors, enable you to process 
larger portions of text at one time. Word processing 
programs are usually screen editors. The MS-DOS editor 
is EDLIN, a line editor. 


EDLIN 
A line editor program that is distributed with MS-DOS. 


Enter Key 
Also referred to as the RETURN key. This key is usually 
pressed after you enter data or after you have typed a 
command. 


ERASE 
An MS-DOS command that erases one or more files. 
(ERASE and DEL both delete files.) 


Error Messages 
Messages that are displayed on the screen when MS-DOS 
detects a problem during command or program execution. 


Expression 
The part of a command or program that can either be true 
or false, for example, a==5 (a equals 5) or EXIST myfile 
(the file myfile exists). The IF batch processing command 
contains a conditional expression and a statement. IF 
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executes the statement only if the conditional expression 
is true. 


Extension 
An optional part of a filename that is used to identify the 
file’s type. Extensions consist of a period (.) and one to 


three characters. Common extensions used in MS-DOS are 
-EXE, .COM, .BAT, and .DAT. 


External Command 
See Command. 


FDISK 
An MS-DOS command that enables you to partition, or set 
up, a fixed disk. 


File 
A collection of related data. Files can contain programs, 
data, or a series of commands. 


Filename 
A name that identifies a file. Filenames can be up to eight 
characters long, not including an optional extension 
which consists of a period and one to three characters. 
MS-DOS reserves certain filenames (AUX, CON, LST, 
PRN, and NUL) which you should not use when you 
name your files. 


Filter 
An MS-DOS command that takes input from a file, device, 
or other command, manipulates it, and then outputs it to 
another file or device. MS-DOS has three filters: FIND, 
MORE, and SORT. 
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Fixed Disk 


A disk consisting of several rigid platters that are 
permanently installed in a fixed disk drive. Fixed disks 
can store much more information than diskettes and 


perform much faster than diskettes. Also called a hard 
disk. 


Floppy Disk 
See Diskette. 


FORMAT 
An MS-DOS command that prepares, or initializes, a 
diskette or fixed disk for use. All new disks must be 
formatted before they can be used by MS-DOS. If disks are 


formatted while they contain data, that data will be 
destroyed. 


Graphics 
The use of diagrams, written symbols, or visual displays to 
obtain data and answers. 


GWBASIC 
A general-purpose computer language, usually the one 
that many people learn first. BASIC stands for Beginner's 
All-purpose Symbolic Instruction Code. 


Hard Disk 
See Fixed Disk. 


Input 
Data sent to the computer. Data is input via the keyboard, 
programs, or other computers. 
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Internal Command 
See Command. 


Kilobyte (Kb) 


A unit of data storage. One kilobyte is equal to 1,024 
bytes. 


Master Disks 
The disks distributed with MS-DOS or other software. You 
should always make a "working copy" of the master disks 
and store the masters in a safe place. 


Megabyte (Mb) 
A unit of data storage. One megabyte is equal to 1,024 
kilobytes (Kb), or 1,048,576 bytes. 


Memory 
Computer storage space for programs and data. 
Information must be stored in memory before the 
computer can use it; however, the information will vanish 
when the computer is not working. Therefore, any data 
you wish to save must be written to a disk before you turn 
off the computer’s power switch or restart the computer. 
Memory is measured in kilobytes (Kb). Computers using 
MS-DOS commonly have 128 Kb of memory or more. 


Monitor 
Often referred to as the CRT (cathode-ray tube) or the 
display screen, a monitor is part of the console (keyboard 
and screen) that enables you to view input and output of 
data. 
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Mouse 
A tool that enables you to control the cursor and assists 
you in the selection of menu items and manipulation of 
data. 


MS-DOS Partition 
The part of the fixed disk that can contain the MS-DOS 
operating system as well as MS-DOS programs and data. 


Network 
A group of computers connected together by a 
communication link. Networks enable you to share data or 
messages among the connected computers. 


Output 
Data that is sent to an output device such as the display 
screen (monitor), printer, or disk drive. 


Partition 
An area of the fixed disk. A fixed disk can have up to four 
partitions. There are three kinds of partitions: MS-DOS 
partitions, DOS data partitions, and partitions used by 
other operating systems. 


Path 
A set of subdirectory names that describes how to get 
from one directory to another. A full pathname starts 
with the root directory, which is abbreviated with a 
backslash (\), and consists of one or more subdirectory 
names, also separated by backslashes. Each subdirectory 
whose name appears in a pathname contains the 
subdirectory whose name appears after it. For example, 
suppose the root directory contains a subdirectory named 
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EDITOR, which, in turn, contains a subdirectory named 
WORK. The full pathname for the WORK subdirectory 
would then be: \EDITOR\WORK. 


Pipe 
A connector between programs or commands that enables 
you to direct the output from one command to be the 
input of another command. The symbol for a pipe is a 
vertical bar (|). Pipes are normally used in conjunction 
with the MS-DOS filters. For example, the command 
DIR | SORT displays a list of files and subdirectories in 
alphabetical order. 


PRINT 
An MS-DOS command that prints your files on a printer 
attached to your computer. 


Program 
A set of instructions, written in computer language, that 
tells the computer how to perform tasks. Programs are 
stored as files on disks and normally have extensions that 
identify them as programs, for example, .COM (meaning 
"command") or .EXE (meaning "executable"). 


Prompt 
A short message that MS-DOS displays when it is ready 
fora command. The MS-DOS prompt consists of the 
default drive letter (A, B, or C) and a greater-than sign 
(>), for example, C>. 


Ramdrive 
A device driver that enables you to use a portion of 
memory as if it were a disk drive. RAM disk drives are 
faster than physical drives because data is always loaded 
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into memory; however, data in a RAM disk is only 
temporary. It disappears when the power to your 
computer goes off. 


Redirection Symbol 
A connector between programs or commands that enables 
you to redirect file input and output to commands, other 
files, or output devices other than the display screen. 
Redirection symbols are the greater-than (>) and less-than 
(<) signs. The > means "output to" and the < means 
"input from." Redirection is normally used in conjunction 
with the MS-DOS filters. For example, SORT < OLD.FIL 
> NEW.FIL sorts each line in OLD.FIL alphabetically and 
stores the sorted output in NEW.FIL. 


RENAME 
An MS-DOS command that changes the name of a file. 
You can use the abbreviation REN instead of RENAME. 


Reset Button 
A button at the lower right front of the computer that 
enables you to restart the system without having to turn it 
off and then back on again. 


Resident portion 
The portion of COMMAND.COM that is loaded into 
memory immediately after the hidden system files. This 
portion remains in memory until you turn the computer 
off. 


Restoring 
Returning files from back-up diskettes to the fixed disk. 
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Return Key 
See Enter Key. 


Root directory 
The main level directory in the MS-DOS hierarchical 
directory structure. The root directory is denoted by a 
backslash (\). 


Sector 
A part of a track on a diskette or fixed disk. A sector 
typically contains 512 bytes. 


Software 
The programs or routines that control or communicate 
with computers. Some examples of software are: operating 
systems, word processing programs, and database 
applications. 


Source 
The file or disk which is to be read or copied by an 
MS-DOS command. The source drive or disk is also 
referred to as the original, first, or master. For example, if 
you are using the DISKCOPY command, the source disk 
would be the one that you want to copy. 


String 
A sequence of letters, numbers, or symbols (often enclosed 
in quotation marks). Normally, a character string is used 
as a message to be displayed on the display screen. 


Subdirectory 
See Directory. 


Glossary-15 


Glossary 


Target 
The file or disk which is to be created or modified by an 
MS-DOS command. The target drive or disk is also 
referred to as the back-up or second. For example, if you 
are using the DISKCOPY command, the target disk would 
be the duplicate or new copy. 


Topic 
An individual subject of help information in a category. 
Topics are used in the Help facility. 


Track 
A circular area on a diskette or fixed disk on which a 
diskette drive can record information without moving its 
read-write head. Tracks are divided into sectors. 


Transient Portion 
The portion of COMMAND.COM that controls the system 
prompt, contains the internal commands, and loads and 
executes external commands and executable files. When 
certain other programs are executed, the transient portion 
of COMMAND.COM may be displaced from memory, and 
MS-DOS may ask you to insert the MS-DOS System 
Diskette before it displays the prompt. 


Tree 
A term used to describe the MS-DOS hierarchical directory 
structure, which resembles an upside down tree with the 
"root" at the top. 


TYPE 
An MS-DOS command used to display files on the screen. 
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Variable 
A placeholder whose value can change. 


Volume 
A label that identifies a disk. 


Wild-Card Characters 
Placeholders in a filename that represent a single character 
or a group of characters. Wild-card characters enable you 
to specify a set of files in a command. The symbols for the 
wild-card characters are * (represents a group of 
characters) and ? (represents a single character). 


Word Processing 
See Editor. 


Working Copy 
A copy of a diskette that you should use instead of the 
master. Using a "working copy" prevents the original 
master from being damaged or destroyed. 


Write-Enable Notch 
The small notch on a diskette below the label on the right 
that allows you to write to and read from the diskette. If 
the diskette does not have a notch or if there is a small tab 
covering the notch (see Write-Protect Tab), you cannot 
change the data on the diskette. 


Write-Protect Tab 
The small tab that covers the write-enable notch on a 
diskette and protects diskettes from being written to. You 
can only read the data on diskettes that are write- 
protected; you cannot change the data unless you remove 
the tab. 
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ABL Processor, 6-6, 6-8 
Absolute disk blocks 
Loading into memory, D-11, 
D-38 
Writing to disk from memory, 
D-12, D-62 
Active partition, changing, 3-34, 
3-41, 3-49 
Address 
In DEBUG, D-4 
Outputting a value to, D-11, 
D-47 
Searching a range of, D-12, 
D-56 
Advanced Batch Language 
Processor, see ABL Processor 
ANSLSYS, 5-14, G-2 
Device driver, installing, G-3 
APPEND command, 5-15 
Areas of memory 
Comparing, D-10, D-19 
RAM disk locations, I-2 
Arguments, 6-12 
Command line, 6-13, 6-15, 6-16 
ASCII characters, J-2 
Assembly language equivalents 
(DEBUG), D-60 
ASSIGN command, 5-17 
Attributes, file, 5-34 
AUTOEXEC.BAT, 4-40, 5-54, 6-11, 
7-7 
AUX, 2-23 
Available memory, dynamically 
allocating, C-13 
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B 


Background printing, 5-115 
BACKSPACE key, 3-13 
BACKUP command, 2-12, 3-78, 
3-83, 4-11, 5-19 
Back-up diskette, 2-16 
Batch commands, 6-4, 6-41 
Batch file 

Creating, 6-10 

Definition of, 6-4 

Example, 6-31 

Executing, 6-7, 6-9 

Naming, 6-6, 6-8 

Stopping Execution of, 6-7, 6-9 

With replaceable parameters, 

6-12 
Batch file commands, displaying, 
6-46 
Batch processing, 4-40, 6-4 
Batch processing commands 

DO UNTIL, 6-44 

ECHO, 6-46 

FOR, 6-48 

GETLINE, 6-57 

GOTO, 6-60 

IF, 6-63, 6-65 

PAUSE, 6-71 

REM, 6-75 

SET, 6-77 

SETINT, 6-79 

SETSTR, 6-81 

SHIFT, 6-82 

WHILE, 6-86 
Batch program, sample, 6-31 
Booting, 3-7 
BREAK command, 5-25, E-6 
Buffers, setting the number of, 
4-35, 7-5, E-7 
Byte, 2-14 
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Cc 


Categories. using, 5-92, 7-24 
Category, 7-3, 7-9, 7-15, 7-24 
Category index, 5-92, 7-24 
OD, see CHDIR command 
‘CHDIR command, 5-27 
CHKDSK command, 5-31 
‘CHMOD command, 3-85, 5-35 
CLS command, 5-39 
COM, 2-23 
‘COMMAND command, 5-40 
Command line, emptying after 
quitting input (EDLIN), B-18 
‘Command processor, 5-40, 5-78 
Resident part, 5-42 
Transient part, 5-42 
Command syntax, 5-6 
COMMAND:COM file, 3-85, 3-90, 
5-40 
Commands 
Batch processing, see Batch 
processing commands 
‘CONFIG SYS, see CONFIG.SYS 
commands 
DEBUG, see DEBUG commands 
EDLIN, see EDLIN commands 
Entering, 1-7, 3-11 
External, 4-6, 4-7, 5-11 
Internal, 4-6-4-8, 5-11 
MS-DOS, see MS-DOS 
commands 
Multiple (EDLIN), B-4 
Comment 
Displayed, 6-46, 6-71 
Not displayed, 6-73 
COMP command, 4-31, 5-43 
Comparing 
Diskettes, 4-21 


Files (COMP command), 4-31, 
5-38 
CON (console), 2-23, 5-51 
Conditional expression, 6-14, 6-22 
CONFIG.SYS, 4-39, 5-46 
‘CONFIG.SYS commands 
BREAK, E-6 
BUFFERS, E-7 
DEVICE, E-8 
DRIVEPARM, E-10 
FCBS, E-13 
FILES, E-15 
LASTDRIVE, E-16 
SHELL, E-18 
CONFIG.SYS file 
Changing, E-2 
Creating, E-2 
Defined, E-2 
Sample, E-20 
Configuring your system, see 
CONFIG.SYS 
‘Control characters (EDLIN), B-2 
With Search or Replace 
(EDLIN), B-5 
COPY command, 4-25, 4-37, 4-42, 
5-47 
Copying 
Diskettes, 4-17 
Files, 4-25—4-29 
CTRL key, 1-7, 3-7, 3-14, 4-15, 
4-36 
CTRL-BREAK, setting, E-6 
CTTY command, 5-56 
Cursor, 3-10 
Customizing your system, see 
CONFIG.SYS 
Cylinder, 3-30, 3-35 
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Data path 

Current, 5-15 

NUL, 5-15 
Data segment, loading all data at 
high end of, C-14 
DATE command, 4-41, 5-53 
DEBUG commands 

(A)ssemble, D-14 

(C)ompare, D-19 

(D)isplay, D-21 

(E)nter, D-24 

(F)ill, D-30 

(G)o, D-32 

(H)ex arithmetic, D-35 

How to start, D-7 

(Dnput, D-37 

(Load, D-38 

(Move, D-41 

(N)ame, D-43 

(O)utput, D-47 

(Q)uit, D-49 

(R)egister, D-51 

(S)earch, D-56 

Summary of, D-10 

Terms used in, D-4 

(T)race, D-58 

(U)nassemble, D-60 

(W)rite, D-62 
DEBUG messages, D-65 
DEBUG program, D-3 

Terminating, D-8. D-49 
Default drive, changing, 3-16 
DEL command, 4-38, 5-60 
Deleting a file, see DEL command 
Destination diskette, see Target 
diskette 


Device driver 
ANSLSYS, G-2 
DRIVERSYS, H-2 
Installing, E-5, E-8 
RAMDRIVESSYS, I-2 
Devices 
Adding additional, 
E-2, 8 
Changing characteristics of, 
E-2, E-10 
Diagnostic messages, 3-7, 3-9, 3-10 
DIR command, 3-70, 4-14, 5-62 
Directory, 2-21, 3-62 
Changing current, see CHDIR 
command 
Creating, see MKDIR command 
Current, 2-27, 2-28 
Removing, see RMDIR 
command 
Root, see Root directory 
Disappearing text, 3-14 
Disk 
Capacity, 4-13 
Drive letters and CONFIGSYS, 
E-3 
Disk, fixed, see Fixed disk 
Disk, floppy, see Diskette 
Disk, hard, see Fixed disk 
Disk drives, configuring, E-3 
Disk files, changing (DEBUG), 
D-62 
Disk operating system, 1-3 
DISKCOMP command, 2-15, 4-21, 
5-60 
DISKCOPY command, 2-15, 3-17, 
4-17, 5-63 
Diskette 
34-inch, 2-9, 2-10, 2-14, 2-15 
5M-inch, 2-3-2-14 
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Back-up, 2-16 
Caring for, 2-3 

Changing when using LINK, 
C6 

Comparing, 5-60 

Copying, 2-11, 2-12, 5-63, see 
also DISKCOPY command 
Double-sided (320 Kb), 4-13 
Double-sided (360 Kb), 2-3, 
2-14, 4-13 

Formatting, 2-12, 4-9, 5-84 
Handling, 2-4 

High-capacity (1.2 Mb), 2-3, 
2-15, 4-13 

Inserting, 2-6 

Labeling, 2-7 

Single-sided (160 Kb), 4-13 


Single-sided (180 Kb), 2-3, 2-14, 


413 
Write-protected, 2-8 

Diskette drives 
Accessing more than four, H-2 
Types of, 4-13 

Disks, recovering, 5-126 

Display mode, setting (MODE 

command), 5-112 

Displaying text file, 4-35 

DO UNTIL command, 6-44 

DOS data partition, 3-23, 3-29 
Creating, 3-41 
Deleting, 3-54 

Drive, current, see Drive, default 

Drive, default, 2-27, 3-16 

Drive, network, 2-27 

Drive alias, 2-27, 5-153 

Drive letter, setting maximum, 

E-5, E-16 

DRIVERSYS, 5-71, H-2 

DRIVERSYS device driver 
Defined, H-2 
Installing, H-3 


Drives 
Adding or changing, E-3, E-8 
Identifying, 2-17—2-19, 2-27 

Dummy parameters, 6-12 


E 


ECHO command, 6-32-6-38, 6-46 
Editing session 
Ending (EDLIN), B-38 
Quitting and not saving 
changes (EDLIN), B-50 
EDLIN, uses of, B-3 
EDLIN commands 
(A)ppend, B-27 
(Copy, B-29 
(D)elete, B-33 
(E)nd, B-38 
How to start, B-8 
Information about, B-4 
(Dnsert, B39 
<line> Edit, B-36 
(Lyist, B-44 
(Move, B-48 
Options, B-25 
(Page, B-49 
(Qhuit, B-50 
(Ryeplace, B-52 
(Search, B-58 
Summary of, B-7 
(T)ransfer, B-63 
(Wyrite, B64 
EDLIN keys, special editing 
DEL, B-14 
ESC, B-18 
Fl, B-ll 
F2, B-12 
F3, B-13 
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F4, B-16 

F5, B23 

INS F3, B-22 

INS, B-20 
EDLIN messages, B-65 
End-of-file, using CTRL-Z 
(EDLIN), B-6 
Environment, 5-15, 6-15, 7-4 
Environment space, increasing, 
E-5, E-18 
ERASE, see DEL command 
Escape sequences, ANSI.SYS, G-2 
EXE2BIN 

Messages, F-5 


Program structure and loading, 


F-2 
EXE2BIN command, 5-72, F-2 
EXEC command, 5-73 
EXIT command, 5-78 
Extension, 2-21 
Reserved, 2-24 
External commands, 4-6, 4-7, 5-11 


F 


FC command, 5-79 
FDISK command 3-32, 5-85 
File 

Archive, 5-36 

Batch, 4-40, 6-4 

Binary, 5-49, 5-72 

Data, 2-20 

Definition of, 2-20 

Executable, 3-67-3-69 

Hidden, 5-36 

Program, 2-20 

Read-only, 5-36 


Index 


Startup, 4-40 
System, 5-35 
Text, 2-20 
Files 
Appending, 5-51 
Comparing, 4-31, 5-73 
Concatenating, 5-53, 
Copying, 4-25 
Creating with EDLIN, B-8 
Deleting, 4-38 
Editing with EDLIN, B-8 
Loading into memory, D-11, 
D-38 
Locating, 4-14 
Merging (EDLIN), B-63 
Naming, 2-21 
Recovering, 5-126 
Removing, 4-38, 5-60 
Renaming, 4-37, 5-129 
Replacing, 3-90, 5-131 
Restoring, 3-86, 5-135 
Sharing, 5-144 
Writing to disk from memory, 
D-12, D-62 
File Control Blocks, specifying 
number of, E-5, E-13 
Filename, 2-21 
Filename 
Extensions, 2-21 
Reserved, 2-23 
Filename parameters, providing 
for Load and Write commands, 
D-11, D-43 
Filenames, providing for Load 
and Write commands, D-11, D-43, 
Filter, 5-9 
FIND command, 5-86 
First diskette, 2-16 
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Fixed disk 
Automatic setup of, 3-25 
Formatting, 2-12, 2-13, 
4-11—4-12, 5-84 
Organizing, 3-67 
Preparing for use, see 
INSTLDOS program 
using, 3-22 
Fixed disk drives, accessing more 
than two, H-2 
Fixed disks, multiple, 3-31, 3-33 
Fixed-disk system, 2-19 
Flag settings, displaying, D-11, 
D-12, D-51, D-58 
FOR command, 6-48 
FORMAT command, 2-15, 3-40, 
4-9, 5-89 
Formatting, 2-12, 3-17 see also 
FORMAT command 


G 


GETLINE command, 6-57 
GOTO command, 6-60 
GRAPHICS command, 3-15, 5-94 


H 


Hard copy, see Printing contents 
of screen 
Help 
Customizing, 4-4, 7-3, 7-32 
Exiting, 7-22 
Indexes, using 7-15, 7-24 
Installing, 7-4 
Quick reference screen, 7-20 


Specifying category name, 7-27, 
7-28 
Specifying topic name, 7-18, 
7-28 
Using, 7-13 
HELP command, 4-4, 5-96, 7-3. 
Help directory, see HELPDIR 
Help text files 
Creating, 7-33 
Editing, 7-37 
Renaming, 7-41 
Help topics. 
Copying, 7-43 
Deleting, 7-42 
Renaming, 7-41 
HELPDIR, 7-4 
HELPDIRPATH variable, 7-4 
Hexadecimal values, calculating 
sum and difference, D-10, D-35 


I 


IF command, 6-63, 6-65 
Initializing, see Formatting 
Input 
Control, 5-56 
Quitting and emptying. 
command line (EDLIN), B-18 
Redirecting, 5-6, 5-56 
Insert mode, entering and exiting 
(EDLIN), B-20 
Installing MS-DOS, 3-32 
INSTLDOS command, 2-13, 3-25. 
3-78, 4-11, 7-7 
Instructions, executing, D-12, 
D-58 
Internal commands, 4-7—4-9, 5-8 
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JOIN command, 5-100 


K 


Keyboard, 3-4, 3-5 

Keyletter, in DEBUG, D-5 
Keys, see EDLIN keys, special 
editing 

Keystrokes, entering, 1-7 


L 


LABEL command, 5-103 
Left arrow key, 3-12 
Libraries 
In object modules, not 
searching, C-17 
To be searched, LINK, C-11 
Line editor, see EDLIN, uses of 
Line numbers 
And addresses, including in list 
file, C-15 
Referenced (EDLIN), B-4 
Specifying (EDLIN), B-25 
Lines 
Appending (EDLIN), B-27 
Copying (EDLIN), B-29 
Deleting (EDLIN), B-32 
Editing (EDLIN), B-35 
Listing (EDLIN), B-43 
Paging through ina file 
(EDLIN), B-49 
Writing to disk from memory 
(EDLIN), B-64 


LINK, 5-105 
Definition of, C-2 
Invoking, C-9, C-17-C-19 
Libraries to be searched, C-12 
Listing, C-11 
Load module, C-11 
Sample session, C-21 
LINK file 
Specifications, format for, C-4 
Usage, C-4 
LINK messages, C-23 
LINK object modules, C-11 
LINK options, C-13 
LINK program, C-3 
Changing diskettes, C-6 
Classes, C-7 
Groups, C-7 
Segments, C-7 
LINK prompts, C-10 
LINK session, pausing in, C-15 
LINK temporary file VM.TMP, 
C5 
Listing, LINK, C-11 
Load module, LINK program, 
Cu 
Logical drive, 3-22 
LPT, 2-23 


M 


Machine code instructions 
(DEBUG), D-3, D-60 
Master diskette, 2-16 
MD, see MKDIR command 
Memory 
Display an area of, D-10, D-21 
Using portion of as a disk 
drive, 1-2 
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Memory addresses 
Changing the value of, D-10, 
D-24 
Filling with specified values, 
D-10, D-30 
Moving values into a range, 
D-11, D-41 
Messages 
Device error, A-3 
EDLIN, B-65 
EXE2BIN, F-5 
LINK, C-23 
MS-DOS, A-5 
Mistakes, correcting, 3-13, 4-42 
MKDIR command, 3-64, 5-106 
MODE command, 5-108 
MORE command, 5-115 
MS-DOS, 1-3, 3-22, 3-78 
Upgrading to Version 3.2, 3-22, 
3-32, 3-78 
MS-DOS batch file 
Executing, 6-7 
Naming, 6-6 
Stopping the execution of, 6-7 
MS-DOS batch processor, 6-6 
MS-DOS commands 
APPEND, 5-15 
ASSIGN, 5-17 
BACKUP, 5-19 
BREAK, 5-25 
CHDIR (CHange DiRectory), 
5-27 
CHKDSK (CHecK DiSK), 5-31 
CHMOD (CHange MODe), 
5-35 
CLS (CLear Screen), 5-39 
COMMAND, 5-40 
COMP (COMPare files), 5-43 
COPY, 5-47 


CTTY (Change TeleTYpe 
device), 5-56 

DATE, 5-58 

DEL (DELete), 5-60 

DIR (DiRectory), 5-62 
DISKCOMP (DiSKette 
COMPare), 5-65 
DISKCOPY (DISKette COPY), 
5-68 

EXE2BIN (EXECutable to 
BINary), 5-72 

EXEC (EXECute), 5-73 
EXIT, 5-78 

FC (File Compare), 5-79 
FDISK (Fixed DISK setup), 5-85 
FIND, 5-86 

FORMAT, 5-89 
GRAPHICS, 5-94 

HELP, 5-96 

JOIN, 5-100 

LABEL, 5-103 

LINK, 5-105 

MKDIR (MaKe DiRectory), 
5-106 

MODE, 5-108 

MORE, 5-115 

PATH, 5-117 

PRINT, 5-119 

PROMPT, 5-122 
RECOVER, 5-126 

REN (REName), 5-129 
REPLACE, 5-131 
RESTORE, 5-135 

RMDIR (ReMove DIRectory), 
5-140 

SET, 5-142 

SHARE, 5-144 

SHIP, 5-146 

SIZE, 5-147 
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SORT, 5-150 
SUBST (SUBSTitute), 5-153 
SYS (SYStem copy), 5-156 
TAG, 5-158 
TIME, 5-164 
TREE, 5-166 
TYPE, 5-172 
UNTAG, 5-174 
VER (VERsion), 5-177 
VERIFY, 5-178 
VOL (VOLume), 5-180 
XCOPY, 5-181 
MS-DOS partition, 3-22 
Creating, 3-34 
Deleting, 3-51 
MS-DOS Supplemental Programs 
Diskette, 1-8, 3-17, 3-38 
MS-DOS System Diskette, 1-8, 
3-7, 3-17, 3-25, 3-32, 3-78, 
45-48 
MS-DOS system files, 3-82, 4-12 
MS-DOS/AT&T Help Diskette, 
1-8, 3-17, 7-3 
Multiple commands (EDLIN), B-4 


N 


Next instructions, displaying, 
D-12, D-58 
Non-MS-DOS partition, 3-23, 3-49 
NUL, 2-23 


Oo 


Object modules, LINK program, 
Cl 
Object program (DEBUG), D-3 
On-screen help, 4-4, 7-3 
Open file, setting number of for 
access, E-5, E-15 
Operating system, 1-3, 3-23, 3-49 
Options, LINK, C-13 
Original diskette, 2-16 
Output 

Control, 5-56 

Redirecting, 5-6, 5-56 


P 


Parallel printer, setting (MODE 
command), 5-108 
Parameter, in DEBUG, D-5 
Parameters 
Dummy, 6-12 
Redefining for "external" block 
devices, E-5, E-8 
Redefining for "internal" block 
devices, E-5, E-10 
Partition, 3-22 
Partition data table, 3-58 
Partitions 
Identifying, 2-19, 2-27 
Planning, 3-22 
Path, 3-64 
PATH command, 3-72, 4-41, 5-117, 
PATH variable, 4-41, 7-4, 7-11 
Pathnames, as options to 
commands (EDLIN), B-4 
PAUSE command, 6-71 
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Pipe, 5-9 
PRINT command, 5-119 
Printer, 3-15 
Printing. contents of screen, 3-15 
PRN, 2-23 
Program 
Executing current one in 
memory, D-10, D-32 
Stepping through (DEBUG), 
D-3, D-50 
Program files, editing,. B-3 
Programming language, 2-20 
Prompt, 3-10, 3-16, 4-5, 4-41 
PROMPT command, 4-41, 5-122 
PrtSc key, 3-15 
Public symbols in input modules, 
C14 


Q 


Question mark (?), as. a command 
option (EDLIN), B-26 


R 


RAMDRIVE, 2-27, 4-39, 1-2 
RAMDRIVE.SYS, 5-125 
RAMDRIVE.SYS device driver 
Defined, I-2 
Installing -4 
Range, in DEBUG, D-5 
RD, see RMDIR command 
Read-only, diskette, see Diskette, 
write-protected! 
Reboot, 3-23 
RECOVER command, 5-126 


Redirecting output, 5-9 
Register and file contents, 
changing (DEBUG), D-3, D-24 
Register values, displaying, D-12, 
D-58 
Registers and flag settings, 
displaying contents of, D-I1, D-51 
REM command, 6-75 
REN command, 4-37, 5-129 
RENAME, see REN command 
REPLACE command, 3-90, 5-131 
Replace mode, entering (EDLIN), 
B-22 
RESET, 3-8 
Resident diagnostics, 3-7, 3-9, 
3-10 
RESTORE command, 2-12, 3-86, 
5-135 
RETURN key, 3-11, 3-12 
Without line specifiers 
(EDLIN), B-25 
RMDIR command, 3-71, 5-140 
Root directory, 3-62 
Root directory and CONFIGSYS, 
E-2 
Run file, placing high in memory, 
cu 


S 


Scrolling, 3-14 

Second diskette, 2-16 

Sector, 2-14, 3-30 
Definition of, 2-14 
Verifying, 5-43 

Serial port, setting (MODE 

command), 5-109 
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SET command, 5-142, 6-77 
SETINT command, 6-79 
SETSTR command, 6-81 
SHARE command, 5-144 
Shell, beginning execution of, 
E-5, E-18, 7-5 
SHIFT command, 6-82 
SHIP command, 5-146 
Single-diskette system, 2-17 
SIZE command, 5-147 
SORT command, 5-150 
Source diskette, 2-16, 3-17, 4-17 
Source file, 4-25 

Creating, B-3 
Spaces, with EDLIN commands, 
B-5S 
Speed reading, alternative to, 
3-14, 4-15, 4-36 
Stack size, specifying, C-15 
Standard input, 5-9 
Standard output, 5-9 
Starting the computer, 3-7 
Startup file, 4-40 
Statements, 6-19 
Subdirectory, 3-62, See also 
Directory 
Subdirectory, creating, see MKDIR 
command 
SUBST command, 2-27, 5-153 
SYS command, 3-82, 5-156 
System, customizing, see 
CONFIGSYS 


T 


TAG command, 5-158 
Target diskette, 2-16, 3-17, 4-17 
Target file, 4-25 


Template 
Copy to command line 
(EDLIN), B-13 
Creating a new one (EDLIN), 
B-23 
Skipping over one character in 
(EDLIN), B-14 

Text file 
Editing, B-3: 

Looking at contents, see TYPE. 
command 

Text string 
Replacing all occurrences of 
(EDLIN), B-52 
Searching for, B-58. 

Text 
Editing a line of (EDLIN), B-36 
Inserting (EDLIN), B-39 
Moving a range of to a 
specified line (EDLIN), B-48 
Searching and replacing 
(EDLIN), B-26, B-52, B-58 

TIME command, 4-41, 5-164 

Topic, 7-4, 7-13 

Topic index, 7-15 

Track, 2-13, 3-30 
Definition of, 2-13 
Comparing, 5-61 

TREE command, 5-166 

Two-diskette system, 2-18 

TYPE command, 4-35, 5-172 

Typing errors, 3-13 


U 


UNTAG command, 5-174 
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Value 
In DEBUG, D-6 
Inputting from an address, 
D-11, D-37 
Value strings in memory, 
disassembling, D-12, D-63 
Variable, 5-142, 6-14, 6-15 
Global, 6-14, 6-15 
In the FOR command, 6-16 
VER command, 5-177 
VERIFY command, 5-178 
Virtual disk, I-2 
VOL command, 5-180 


WwW 


WHILE command, 6-86 
Wild-card characters, 2-25, 4-25, 
4-26 

Working diskettes, creating, 3-17 
Write-enable notch, 2-8 
Write-protect tab, 2-8 


x 


XCOPY command, 5-181 
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